home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d7 / commo45.arc / COMMO.DOC < prev    next >
Text File  |  1991-01-11  |  154KB  |  4,206 lines
  1.  
  2.  
  3.  
  4.                                  ____________
  5.  
  6.                                  {COMMO} (tm)
  7.                                  ____________
  8.  
  9.  
  10.                     "A New Standard in Telecommunications"
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.                                       by
  18.  
  19.                                 Fred P. Brucker
  20.  
  21.                              Post Office Box 9103
  22.                              Santa Rosa, CA 95405
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.                            User Guide and Reference
  30.  
  31.  
  32.  
  33.  
  34.                                  Release 4.5
  35.  
  36.                               January 12, 1991
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.        This program and associated documentation are the property of the
  44.        author and may not be sold without permission.  They may be freely
  45.        distributed, unaltered and as a unit, via electronic bulletin board
  46.        systems.  Permission to distribute on diskette or in any other
  47.        manner must be obtained in writing.
  48.  
  49.        The author does not guarantee the program to be free from defects
  50.        and may not be held responsible for loss caused by such.  Your use
  51.        of this program constitutes your acceptance of these terms.
  52.  
  53.  
  54.  
  55.  
  56.            (C)Copyright 1989,1991  Fred P. Brucker  All Rights Reserved
  57.  
  58.  
  59.  
  60.                    {COMMO} (tm)  User Guide and Reference           page ii
  61.  
  62.  
  63.        =====================
  64.        Licensing Information
  65.        =====================
  66.  
  67.        {COMMO} is not a public domain program and is not free.  It is
  68.        classified as "SHAREWARE."  What this means is that you may use the
  69.        program for 30 days to determine its suitability to your
  70.        application.  If after that time you decide to continue using
  71.        {COMMO} you must pay the registration fee.
  72.  
  73.        {COMMO} is a unique program and represents a great deal of work.  A
  74.        lot of functionality has been compressed into a small package, and
  75.        more features are being added on a continuing basis.  If you find
  76.        {COMMO} useful and enjoyable, you can help support future
  77.        improvements by registering your copy.
  78.  
  79.  
  80.        A single-user license is $25.00.  A diskette containing the current
  81.        release (specify 5.25" or 3.5") will be provided for a $5.00
  82.        handling fee.  Send a check or money order (US funds) to the address
  83.        below.
  84.  
  85.        Details and a multi-user (site) license price schedule are provided
  86.        in the file REGISTER.FRM.
  87.  
  88.        See also the enclosed file LICENSES for complete licensing,
  89.        distribution and copyright information.
  90.  
  91.        My telephone number for inquiries and support for registered users
  92.        is (707) 573-1065.  Please restrict calls to business hours (Pacific
  93.        time).
  94.  
  95.         
  96.        Thank you, and I hope you enjoy {COMMO}.
  97.  
  98.  
  99.                                              Fred P. Brucker
  100.                                              P.O. Box 9103
  101.                                              Santa Rosa, CA 95405
  102.  
  103.  
  104.  
  105.                    {COMMO} (tm)  User Guide and Reference          page iii
  106.  
  107.  
  108.        ========
  109.        Contents
  110.        ========
  111.  
  112.  
  113.           Preface . . . . . . . . . . . . . . . . . . . . . . . . . . .   1
  114.  
  115.           Principal Features  . . . . . . . . . . . . . . . . . . . . .   2
  116.                The Best Way to Learn {COMMO} Quickly  . . . . . . . . .   4
  117.  
  118.           Getting Started . . . . . . . . . . . . . . . . . . . . . . .   4
  119.                Command Line Options . . . . . . . . . . . . . . . . . .   5
  120.                {COMMO} Support Files  . . . . . . . . . . . . . . . . .   7
  121.                Saving the Support Files . . . . . . . . . . . . . . . .   8
  122.                Initialization Procedure . . . . . . . . . . . . . . . .   8
  123.                Terminal Screen  . . . . . . . . . . . . . . . . . . . .   9
  124.  
  125.           {COMMO} Key Commands  . . . . . . . . . . . . . . . . . . . .   9
  126.                [Alt-A]   ASCII Upload . . . . . . . . . . . . . . . . .  10
  127.                [Alt-B]   Send Break Signal  . . . . . . . . . . . . . .  11
  128.                [Alt-C]   Clear Screen . . . . . . . . . . . . . . . . .  11
  129.                [Alt-D]   Dialing Directory  . . . . . . . . . . . . . .  11
  130.                [Alt-G]   Configuration File . . . . . . . . . . . . . .  14
  131.                     Explanation of items  . . . . . . . . . . . . . . .  14
  132.                [Alt-H]   How to Use Online Help . . . . . . . . . . . .  24
  133.                     Modifying the Help File . . . . . . . . . . . . . .  24
  134.                [Alt-I]   Screen Image Save  . . . . . . . . . . . . . .  25
  135.                [Alt-K]   Scrollback . . . . . . . . . . . . . . . . . .  25
  136.                [Alt-L]   Set Terminal Parameters  . . . . . . . . . . .  25
  137.                     Parameter Descriptions  . . . . . . . . . . . . . .  26
  138.                     Setting Terminal Parameters . . . . . . . . . . . .  27
  139.                [Alt-M]   Macro Processor  . . . . . . . . . . . . . . .  28
  140.                [Alt-O]   Send Modem Initialization String . . . . . . .  28
  141.                [Alt-P]   Send Current Password  . . . . . . . . . . . .  29
  142.                [Alt-Q]   Quit Call (hang up)  . . . . . . . . . . . . .  29
  143.                [Alt-S]   Shell to DOS . . . . . . . . . . . . . . . . .  29
  144.                [Alt-U]   Multi Number Dialing . . . . . . . . . . . . .  29
  145.                [Alt-X]   Exit from {COMMO}  . . . . . . . . . . . . . .  30
  146.                [Alt-1]   Capture File Options . . . . . . . . . . . . .  30
  147.                [Alt-2]   Print Log Toggle . . . . . . . . . . . . . . .  31
  148.                [Alt-3]   Sound Control Toggle . . . . . . . . . . . . .  31
  149.                [Alt-4]   AutoBaud Toggle  . . . . . . . . . . . . . . .  32
  150.                [Alt-5]   Local Echo Toggle  . . . . . . . . . . . . . .  32
  151.                [Alt-0]   Signal Lights Toggle . . . . . . . . . . . . .  33
  152.                [Alt--]   Chat Mode Toggle  (Alt minus)  . . . . . . . .  33
  153.                [Alt-=]   Doorway Mode Toggle  . . . . . . . . . . . . .  34
  154.  
  155.           Uploading / Downloading . . . . . . . . . . . . . . . . . . .  34
  156.                {COMMO} Auto Receive . . . . . . . . . . . . . . . . . .  35
  157.  
  158.  
  159.  
  160.                    {COMMO} (tm)  User Guide and Reference           page iv
  161.  
  162.  
  163.  
  164.           Programming {COMMO} Macros  . . . . . . . . . . . . . . . . .  36
  165.                Macro-id and Function Summary  . . . . . . . . . . . . .  38
  166.                Additional Macro File Rules  . . . . . . . . . . . . . .  38
  167.                Executing Macros . . . . . . . . . . . . . . . . . . . .  38
  168.                Additional Macro Execution Rules . . . . . . . . . . . .  39
  169.  
  170.           {COMMO} Macro Functions . . . . . . . . . . . . . . . . . . .  40
  171.                Function Arguments . . . . . . . . . . . . . . . . . . .  40
  172.                Description of Functions (alphabetical)  . . . . . . . .  41
  173.                Table of {COMMO} Key-id's  . . . . . . . . . . . . . . .  59
  174.                Enhanced Keyboard Key-id's . . . . . . . . . . . . . . .  60
  175.  
  176.           Appendix A   Setting Up Your Modem  . . . . . . . . . . . . .  61
  177.  
  178.           Appendix B   {COMMO} and Multi-Tasking  . . . . . . . . . . .  63
  179.                DESQview . . . . . . . . . . . . . . . . . . . . . . . .  63
  180.                OmniView . . . . . . . . . . . . . . . . . . . . . . . .  64
  181.                DoubleDOS  . . . . . . . . . . . . . . . . . . . . . . .  64
  182.  
  183.           Appendix C   Flow Control . . . . . . . . . . . . . . . . . .  65
  184.  
  185.           Appendix D   ASCII Character Representation . . . . . . . . .  66
  186.  
  187.           Appendix E   Terminal Emulation . . . . . . . . . . . . . . .  68
  188.                Printer Support  . . . . . . . . . . . . . . . . . . . .  68
  189.                ANSI-BBS Keyboard Support  . . . . . . . . . . . . . . .  69
  190.                VT102 Keyboard Simulation  . . . . . . . . . . . . . . .  69
  191.  
  192.           Appendix F   Error Message Explanations . . . . . . . . . . .  71
  193.  
  194.  
  195.  
  196.                    {COMMO} (tm)  User Guide and Reference           page 1
  197.  
  198.  
  199.        =======
  200.        Preface
  201.        =======
  202.  
  203.        {COMMO} is a general purpose telecommunications program, also called
  204.        a "terminal" program.  It offers the capability to dial remote
  205.        systems and to communicate using a choice of terminal emulations. 
  206.        Many features are available to enhance your communications needs.
  207.  
  208.        Other than the ability to transfer ASCII text files, {COMMO} has no
  209.        internal file transfer protocols.  Instead it provides you with
  210.        powerful tools to execute external programs which specialize in this
  211.        ability.
  212.  
  213.        {COMMO} will run on any PC compatible computer with at least 64k of
  214.        memory and one diskette drive.  A serial port or internal modem with
  215.        an 8250, 16450 or 16550 series UART chip is required.
  216.  
  217.        {COMMO} can be configured to work with virtually any type of modem
  218.        that supports asynchronous operations.
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.        LIST is a product of Vernon D. Buerg
  234.        DESQview is a trademark of Quarterdeck Office Systems
  235.        OmniView is a trademark of Sunny Hill Software
  236.        DoubleDOS is a trademark of SoftLogic Solutions, Inc.
  237.        DSZ is a product of Omen Technology Inc.
  238.        AutoDownload is a trademark of Omen Technology Inc.
  239.        MPt is a product of Matthew Thomas
  240.  
  241.  
  242.  
  243.                    {COMMO} (tm)  User Guide and Reference           page 2
  244.  
  245.  
  246.        ==================
  247.        Principal Features
  248.        ==================
  249.  
  250.        {COMMO} is small in size, loads rapidly and performs all functions
  251.        with great speed.
  252.  
  253.        The powerful Macro Processor allows you to:
  254.  
  255.        1) write macro "scripts" to automate many common operations such as
  256.           logins, reading messages, uploading/downloading.  You can sit
  257.           back and watch {COMMO} do the work -- or you can let {COMMO}
  258.           perform these tasks in the middle of the night while you sleep.
  259.  
  260.        2) assign Function Keys, Alt Keys, Keypad Keys, etc., to send a
  261.           string to the modem, execute any DOS command, start any macro or
  262.           initiate any {COMMO} function.
  263.  
  264.        3) edit all macros without exiting {COMMO}, using the Internal
  265.           Editor.  
  266.  
  267.        Free-form Dialing Directory has space for hundreds of entries. 
  268.        Multi Number Dialing is supported from the command line.  AutoBaud
  269.        detect adjusts to the speed of the connection.  A Macro may be
  270.        linked to each directory entry.
  271.  
  272.        Multi-tasking support.  {COMMO} is DESQview aware, operates in as
  273.        little as 40k and will execute with DSZ in a 120k DV window
  274.        (depending on support file sizes).  Also supports OmniView,
  275.        DoubleDOS and others.
  276.  
  277.        Built-in ANSI-BBS and VT102 emulation.  Supports ANSI editing
  278.        functions, scrolling region, graphics character set, tab set/clear,
  279.        printing, modes, reports, etc.  Complete auto-switching VT102
  280.        keyboard support via Macro Processor.
  281.  
  282.        ASCII Upload to send messages and text files.  Features line pacing
  283.        and blank line expansion.
  284.  
  285.        Configuration File, Dialing Directory and Macro File may be edited
  286.        with full-function Internal Editor.  String search available in all
  287.        file windows.  Most features are fully configurable.
  288.  
  289.        Split-screen Chat Mode -- all program features are available while
  290.        in Chat Mode.
  291.  
  292.        Doorway Mode lets you operate remote applications with full use of
  293.        your screen and keyboard.
  294.  
  295.        {COMMO}'s Auto Receive feature lets you configure any four strings
  296.        to automatically trigger any four macros.  Thus any protocol with a
  297.  
  298.  
  299.  
  300.                    {COMMO} (tm)  User Guide and Reference           page 3
  301.  
  302.  
  303.        "signature" can be set to start automatically.  Zmodem and MPt are
  304.        two examples that are pre-configured.
  305.  
  306.        Support for any four serial ports.  Port addresses and IRQ's are
  307.        configurable.  Port speeds up to 115,200 bps (machine dependent). 
  308.        Support for NS16550A (or AF) buffered UART chip.
  309.  
  310.        Serial port signal lights may be displayed on the status line,
  311.        including send and receive.  Very useful with internal modems.
  312.  
  313.        Scrollback buffer up to 64k bytes gives instant replay of the text
  314.        that has scrolled off the screen.
  315.  
  316.        Capture Log to save all text from the screen to a disk file.  Three
  317.        different capture modes are available.
  318.  
  319.        Screen Image Save to write current screen to a disk file.
  320.  
  321.        Print Log to write all text from the screen to the printer.
  322.  
  323.        Usage Log records date, time, length of call and other information
  324.        about each call.  Date of last call can be saved in Dialing
  325.        Directory.
  326.  
  327.        Support for visually impaired users, including BIOS Terminal Screen
  328.        writes and special sounds when errors occur.
  329.  
  330.        Enhanced keyboard support.
  331.  
  332.        Extensive context-related Online Help.
  333.  
  334.  
  335.        And {COMMO} is elegant, easy to learn and fun to use!
  336.  
  337.  
  338.  
  339.                    {COMMO} (tm)  User Guide and Reference           page 4
  340.  
  341.  
  342.                     !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
  343.                     -------------------------------------
  344.                     The Best Way to Learn {COMMO} Quickly
  345.                     -------------------------------------
  346.                     !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
  347.  
  348.  
  349.        1) Read the section "Getting Started" which will get you up and
  350.           running.
  351.  
  352.        2) Read Appendix A "Setting Up Your Modem" for some very important
  353.           instructions pertaining to your specific hardware.
  354.  
  355.        3) Read through the section "{COMMO} Key Commands" to familiarize
  356.           yourself with {COMMO}'s commands and features.
  357.  
  358.        4) Use Online Help as a reference while you use {COMMO}.
  359.  
  360.  
  361.        How is it pronounced???  Just like "comma" (,) except for the last
  362.        letter.  It's technical jargon for "communications."
  363.  
  364.  
  365.        ===============
  366.        Getting Started
  367.        ===============
  368.  
  369.        First make sure that all of the files from the {COMMO} package are
  370.        in one directory or on one diskette.  Four of these files are
  371.        required to run the {COMMO} program: 
  372.  
  373.             COMMO.COM      the Program File
  374.             COMMO.CFG      the Configuration File
  375.             COMMO.FON      the Dialing Directory File
  376.             COMMO.MAC      the Macro File
  377.  
  378.        In addition, if Online Help is used (recommended):
  379.  
  380.             COMMO.HLP      the Online Help File
  381.  
  382.        There are two ways to make sure that {COMMO} will be able to find
  383.        all of its files.  The first method is the simplest and should be
  384.        used if you are not too familiar with DOS commands:
  385.  
  386.        1) Make sure you are logged into the directory or disk drive where
  387.           the files are located.  Then simply type "commo" at the DOS
  388.           prompt.  If your files are in the directory "C:\COMMO" you would
  389.           type:
  390.  
  391.                c:<cr>
  392.                cd \commo<cr>
  393.                commo<cr>
  394.  
  395.  
  396.  
  397.                    {COMMO} (tm)  User Guide and Reference           page 5
  398.  
  399.  
  400.  
  401.           (<cr> is the [Enter] or Return key)
  402.  
  403.           Or if the files are on a diskette in drive A you would type:
  404.  
  405.                a:<cr>
  406.                commo<cr>
  407.  
  408.           {COMMO} will remember where the files are, so you will be able to
  409.           change directory or drive later without concern.
  410.  
  411.        2) The second method is a little more advanced, but allows you to
  412.           run {COMMO} no matter what directory or drive you are currently
  413.           logged into:
  414.  
  415.           Use the SET command in DOS to store the {COMMO} path into the
  416.           "environment."  If you place this command in your AUTOEXEC.BAT
  417.           file you won't have to change directories or diskettes to run
  418.           {COMMO}.  If your files are in the directory "C:\COMMO" the
  419.           command would be:
  420.  
  421.                set commo=c:\commo
  422.  
  423.           If the files are on the diskette in drive B the command would be:
  424.  
  425.                set commo=b:
  426.  
  427.           Do not use any extra spaces in the SET command.  And remember to
  428.           place the {COMMO} directory or drive in your PATH command.
  429.  
  430.           IMPORTANT:  Remember to execute the "set commo=" command again if
  431.           you install {COMMO} into a different directory or onto another
  432.           drive.  Otherwise the new copy will refer back to the old
  433.           directory and use the old support files.  This is a common error
  434.           and can cause a lot of head scratching.
  435.  
  436.  
  437.        ====================
  438.        Command Line Options
  439.        ====================
  440.  
  441.           _______________
  442.  
  443.           Dialing Strings
  444.           _______________
  445.  
  446.        Dialing Strings may be placed before any command line switches. 
  447.        {COMMO} will search the Dialing Directory for each string and mark
  448.        the first entry where a match is found (case is ignored).
  449.  
  450.        The strings may consist of any part of a Dialing Directory entry
  451.        line and may be separated by commas or spaces.  The following
  452.  
  453.  
  454.  
  455.                    {COMMO} (tm)  User Guide and Reference           page 6
  456.  
  457.  
  458.        characters may not appear in a Dialing String: space, comma, slash
  459.        (/), left or right curly brace.
  460.  
  461.        After entries in the Dialing Directory are marked, {COMMO} will
  462.        check for a Startup Macro (see below).  If no valid macro-id is
  463.        present Multi Number Dialing of the marked systems will begin.  If a
  464.        macro is present it will be started instead.
  465.  
  466.        The Modem Initialization String will be sent before dialing begins
  467.        unless the switch "/I=no" is present on the command line.
  468.  
  469.        Examples:
  470.  
  471.                 commo telegodzilla joes-bbs 4567 
  472.  
  473.                 commo zilla,joes,4567
  474.  
  475.        IMPORTANT: Your modem should be turned on and ready to receive the
  476.        Modem Initialization String before starting the program.
  477.  
  478.           ________
  479.  
  480.           Switches
  481.           ________
  482.  
  483.        Case is ignored and the switches may be in any order (Dialing
  484.        Strings must be first, however).  The alternate forms without the
  485.        "=" must be used if switches are to be passed as batch file
  486.        parameters ("=" acts as a delimiter on the command line).
  487.  
  488.          /C=filename or /Cfilename      default:  COMMO.CFG
  489.  
  490.        Alternate Configuration File.  The alternate file must reside in the
  491.        {COMMO} home directory.
  492.  
  493.          /I=[yes/no] or /I[yes/no]      default:  none
  494.  
  495.        This switch may be used to inhibit the Modem Initialization when
  496.        Dialing Strings and/or a Startup Macro are present: "/I=no."
  497.  
  498.        It may also be used to bypass the question "Initialize modem?" on
  499.        the Initialization Screen: "/I=yes" or "/I=no."
  500.  
  501.          /L=nn or /Lnn                  default: 25
  502.  
  503.        "nn" is the total number of display lines on the screen.  {COMMO}
  504.        will support 25 or more lines, but the display MUST be set before
  505.        starting the program (there are utilities to set modes with 43
  506.        lines, 50 lines, etc.).
  507.  
  508.  
  509.  
  510.                    {COMMO} (tm)  User Guide and Reference           page 7
  511.  
  512.  
  513.        If you want {COMMO} to automatically adjust to the current number of
  514.        lines on the screen, set the Configuration File item under "Video
  515.        and Chat Mode" to "yes."
  516.  
  517.        The cursor may not display properly in 43 line mode.  This is a
  518.        problem with some EGA adapters.
  519.  
  520.          /M=macro-id or /Mmacro-id      default:  none
  521.  
  522.        Startup Macro.  The "macro-id" is a three character macro
  523.        identifier.  If the macro is found in the Macro File it will be
  524.        started.  If the macro is not found the switch will be ignored.
  525.  
  526.        The Modem Initialization String will be sent before starting the
  527.        macro unless the switch "/I=no" is present on the command line. 
  528.  
  529.        Example:
  530.  
  531.                  commo joes zilla /c=other.cfg /m=abc
  532.  
  533.        Two systems will be marked in the Dialing Directory.  The alternate
  534.        Configuration File "other.cfg" will be used (it must be located in
  535.        the {COMMO} home directory).  The macro "abc" will be started if it
  536.        exists in the Macro File.
  537.  
  538.  
  539.        =====================
  540.        {COMMO} Support Files
  541.        =====================
  542.  
  543.        The {COMMO} files are standard ASCII text files and may be modified
  544.        with any editor (or word processor in "non-document" mode).  In
  545.        addition all but the Online Help File may be edited with {COMMO}'s
  546.        Internal Editor.
  547.  
  548.        Key definitions for the Internal Editor are given in Online Help.  A
  549.        Color Chart will be displayed in the editor when F10 is pressed
  550.        (useful in the Configuration File and for the DISPlay function in
  551.        the Macro File).
  552.  
  553.        NOTE: {COMMO} generally retains the files in memory during program
  554.        operation.  If you use an external editor to modify them while in
  555.        the Shell to DOS (or using the EXEC macro function), your changes
  556.        could be lost.  See "Saving the Support Files" below.
  557.  
  558.        Following is a brief description of each file. 
  559.  
  560.        1) COMMO.CFG.  The Configuration File contains settings for many
  561.           important parameters.  The first time you run {COMMO} you should
  562.           use the Alt-G key command to edit this file to your own needs. 
  563.           See "Alt-G  Configuration File" for details on each item.
  564.  
  565.  
  566.  
  567.                    {COMMO} (tm)  User Guide and Reference           page 8
  568.  
  569.  
  570.        2) COMMO.FON.  The Dialing Directory File.  This file contains
  571.           information about the systems you will be calling, including the
  572.           telephone numbers, passwords, macro link and serial port
  573.           parameters.  Use the Alt-D key command to dial numbers and to
  574.           edit this file.  Details are given in the section "Alt-D  Dialing
  575.           Directory."
  576.  
  577.        3) COMMO.MAC.  The Macro File.  Use the Alt-M key command to select
  578.           a macro for execution and to edit this file.  A complete
  579.           description of {COMMO} macros is given in the section
  580.           "Programming {COMMO} Macros" in this document.  A summary of
  581.           macro functions and key designators is also given in Online Help.
  582.  
  583.        4) COMMO.HLP.  The Online Help File.  This file contains the
  584.           information for {COMMO}'s context-related Online Help.  See "How
  585.           to Use Online Help" later in this document.
  586.  
  587.  
  588.        Saving the Support Files
  589.        ========================
  590.  
  591.        Whenever a change is made to any support file (by {COMMO} or by  
  592.        you), the internal change flag is set for that file.  When you exit
  593.        {COMMO}, changed files will automatically be saved to disk.  File
  594.        changes are also saved in the following situations:
  595.  
  596.        1) In the Internal Editor you may press Alt-F and the file will be
  597.           saved to disk immediately.
  598.  
  599.        2) The memory occupied by the Configuration File is released at
  600.           certain times (e.g., when you Shell to DOS).  In this case the
  601.           file will be saved prior to releasing the memory.
  602.  
  603.        If you do not wish to save your changes to the Dialing Directory or
  604.        Macro File, then you may press Alt-Q while in the Internal Editor. 
  605.        This will reset {COMMO}'s change flag and the file will not be saved
  606.        when exiting the program.  Any subsequent changes to the file will
  607.        set the change flag again.
  608.  
  609.  
  610.        ========================
  611.        Initialization Procedure
  612.        ========================
  613.  
  614.        When {COMMO} begins running it will process the Configuration File. 
  615.        Then it will attempt to load into memory:
  616.  
  617.           (1) the Dialing Directory     COMMO.FON
  618.           (2) the Macro File            COMMO.MAC
  619.  
  620.        Any problems encountered will be reported.  These problems must be
  621.        corrected before restarting the program.
  622.  
  623.  
  624.  
  625.                    {COMMO} (tm)  User Guide and Reference           page 9
  626.  
  627.  
  628.  
  629.        Automatic modem initialization will occur if Dialing Strings are
  630.        present (and matches are found), or if the Startup Macro Switch is
  631.        present (see "Command Line Options").
  632.  
  633.        Otherwise you will be asked if you want to initialize your modem. 
  634.        Answer "yes" unless you are already on line.
  635.  
  636.        Please note that {COMMO} does NOT change the video display mode. 
  637.        This means simply that the video mode must be set (usually 25 by 80
  638.        color or monochrome) when you call up the program.  This allows you
  639.        to set video parameters such as the number of display lines or the
  640.        screen border color and not have them rudely changed when the
  641.        program is started (see "Command Line Options").
  642.  
  643.        If the display does not look right try executing the DOS command 
  644.        "mode co80" or "mode bw80" prior to calling {COMMO}.
  645.  
  646.  
  647.        ===============
  648.        Terminal Screen
  649.        ===============
  650.  
  651.        The Terminal Screen allows you to see the characters coming in from
  652.        the serial port.  Any characters that you type will be sent out to
  653.        the serial port.  If you are connected to another system you will be
  654.        interacting with that system.
  655.  
  656.        Keep in mind that you will also be interacting with {COMMO} and with
  657.        your own computer via key commands (Alt keys, for example).  These
  658.        key commands have no effect on the remote system unless they cause
  659.        characters to be sent to the serial port (pressing Alt-P to send
  660.        your password, for example).
  661.  
  662.  
  663.        ====================
  664.        {COMMO} Key Commands
  665.        ====================
  666.  
  667.        The Alt Keys shown in this section are the built-in default key
  668.        assignments for the various {COMMO} commands.  Once you are familiar
  669.        with these commands you may use the Macro Processor to reassign any
  670.        of the keys.
  671.  
  672.        Keys used within the various command windows are properly detailed
  673.        in Online Help.  Please press Alt-H from any command window to
  674.        invoke {COMMO}'s context-related help system.
  675.  
  676.        Note that certain features are only available as macro functions. 
  677.        Read the section "Programming {COMMO} Macros" for details.
  678.  
  679.  
  680.  
  681.                    {COMMO} (tm)  User Guide and Reference           page 10
  682.  
  683.  
  684.        ======================
  685.        [Alt-A]   ASCII Upload
  686.        ======================
  687.  
  688.        This command is used to send prepared messages or any text files to
  689.        the remote system.  Enter the pathname of the file you wish to send.
  690.  
  691.        There is no special error checking associated with ASCII Upload.  It
  692.        is intended primarily for sending message responses and other short
  693.        text files.  For longer files, binary files or compressed files
  694.        (.ARC, .ZIP) you will want to use error checking protocols such as
  695.        Zmodem or MPt.  See "Uploading / Downloading."
  696.  
  697.        A number of parameters are used to control an ASCII Upload:
  698.  
  699.           ___________
  700.  
  701.           Line Pacing
  702.           ___________
  703.  
  704.        Line Pacing is used to keep transmitted data synchronized with
  705.        received (echoed) data and is used when a prompt is being sent for
  706.        each line, usually "nn:" or "nn?".  "nn" is a line number and ":" or
  707.        "?" is called the "pacing character."  {COMMO} will wait for the
  708.        pacing character (maximum wait is 5 seconds), then send the next
  709.        line.
  710.  
  711.        To use line pacing, enter the pacing character when {COMMO} asks for
  712.        it.  Do not use line pacing with full-screen editors (backspace to
  713.        delete the pacing character when asked for it).
  714.  
  715.        The initial pacing character is configurable.  See "Alt-G
  716.        Configuration File."
  717.  
  718.        The pacing character may be any character including control
  719.        characters, e.g. "^m" or "|" for carriage return.  See Appendix D
  720.        for details on how to represent special characters.
  721.  
  722.        See also Appendix C "Flow Control."
  723.  
  724.           ________________
  725.  
  726.           Character Pacing
  727.           ________________
  728.  
  729.        You may insert a delay between each character using the Inter-
  730.        Character Delay feature.  This should only be used when the remote
  731.        is so slow that characters are dropped, even when line pacing is on. 
  732.        See "Set Terminal Parameters" for details.
  733.  
  734.  
  735.  
  736.                    {COMMO} (tm)  User Guide and Reference           page 11
  737.  
  738.  
  739.           ___________________
  740.  
  741.           Stripping Linefeeds
  742.           ___________________
  743.  
  744.        Normally you will want to strip linefeeds from your outgoing text. 
  745.        This will appear to the remote as if you are typing the data.  But
  746.        if all your data displays on the same line at the remote, then you
  747.        must configure {COMMO} to send the linefeeds.
  748.  
  749.        Note: This is a Configuration File item.
  750.  
  751.           _____________________
  752.  
  753.           Expanding Blank Lines
  754.           _____________________
  755.  
  756.        You may configure {COMMO} to send a space character whenever a blank
  757.        line is encountered in the text file you are sending.  This will
  758.        prevent your message from terminating prematurely if you are sending
  759.        to a BBS message editor.  Blank line expansion is not normally
  760.        required when sending to a "full screen" BBS editor.
  761.  
  762.        Note: This is a Configuration File item.
  763.  
  764.  
  765.        ===========================
  766.        [Alt-B]   Send Break Signal
  767.        ===========================
  768.  
  769.        A one second Break Signal will be sent.  This signal is used by some
  770.        systems to interrupt certain operations, such as continuous output.
  771.  
  772.  
  773.        ======================
  774.        [Alt-C]   Clear Screen
  775.        ======================
  776.  
  777.        The Terminal Screen will be cleared and the current colors will be
  778.        set to the Configuration File defaults.
  779.  
  780.  
  781.        ===========================
  782.        [Alt-D]   Dialing Directory
  783.        ===========================
  784.  
  785.        The Dialing Directory is your data base of telephone numbers.  From
  786.        the directory window you can select numbers to dial and also update
  787.        the directory using the Internal Editor.
  788.  
  789.  
  790.  
  791.                    {COMMO} (tm)  User Guide and Reference           page 12
  792.  
  793.  
  794.        _______________________________
  795.  
  796.        Dialing Directory Entry Example
  797.        _______________________________
  798.  
  799.  
  800.          System       Telephone    System    Linked   Serial Port   Last
  801.          Name         Number       Password  Macro    Parameters    Called
  802.        _____________  __________  _________   _____  ____________  ________
  803.  
  804.        File City BBS  {555-1234}  {aardvark}  {abc}  {2400,8n1,1}  05/20/90
  805.  
  806.  
  807.        IMPORTANT: Items in curly braces must be present (they are
  808.        positional).  Items which are not used must have a null string {} as
  809.        a placeholder.  You may omit null strings at the end of the line.
  810.  
  811.        Directory entries are limited to one per line (up to 255
  812.        characters).
  813.  
  814.        Comments may be placed anywhere outside the curly braces or on
  815.        separate lines.
  816.  
  817.        ______________________________
  818.  
  819.        System Name      File City BBS
  820.        ______________________________
  821.  
  822.           Up to 40 characters in length,  it must NOT be enclosed in curly
  823.           braces.  The System Name will be displayed on the Status Line
  824.           after connection, unless the Signal Lights option is selected. 
  825.           It will also be part of a Usage Log entry if the log is enabled.
  826.  
  827.        ______________________________________
  828.  
  829.        Telephone Number      {1-707-555-1234}
  830.        ______________________________________
  831.  
  832.           Spaces and hyphens are ignored by most modems.  The Dialing
  833.           Prefix, Telephone Number and Dialing Suffix are used to form a
  834.           dialing command.  Refer to your modem manual for details on
  835.           dialing commands.
  836.  
  837.           The Dialing Prefix may be chosen from a list of four in the
  838.           Configuration File and is indicated by #1,#2,#3 or #4.  The
  839.           prefix code must appear right after the left curly brace:
  840.  
  841.                {#2 1-707-555-1234}     Use prefix 2
  842.  
  843.           Dialing Prefix 1 is the default if none is specified.
  844.  
  845.  
  846.  
  847.                    {COMMO} (tm)  User Guide and Reference           page 13
  848.  
  849.  
  850.           The Telephone Number is limited to 40 characters, excluding any
  851.           prefix code.
  852.  
  853.        _________________________________
  854.  
  855.        System Password      {mypassword}
  856.        _________________________________
  857.  
  858.           A different Password String may be defined for each system that
  859.           you call.  Passwords may be up to 64 characters in length.
  860.  
  861.           The Password String may be sent using Alt-P or by using the #
  862.           symbol in a SEND macro function.
  863.  
  864.           Passwords are invisible in the Dialing Directory window, but
  865.           appear when you enter [E]dit mode.
  866.  
  867.           Rules for writing passwords are in Appendix D.
  868.  
  869.        _______________________
  870.  
  871.        Linked Macro      {abc}  
  872.        _______________________
  873.  
  874.           If a Linked Macro is specified it will be executed when a
  875.           connection is established with the remote system.  If no macro is
  876.           specified (or the macro-id is invalid), {COMMO} will enter the
  877.           Terminal Screen.
  878.  
  879.        ________________________________________
  880.  
  881.        Serial Port Parameters      {2400,8n1,1}
  882.        ________________________________________
  883.  
  884.           {Speed,Format,Comport}
  885.  
  886.           This item allows you to override the default settings for the
  887.           current call.  Include only the parameters that are different
  888.           from the settings in your Configuration File.
  889.  
  890.           For example you might have "{,7}", which would set the Data
  891.           Format to "7e1", but use the default settings for the other
  892.           parameters.
  893.  
  894.           See "Set Terminal Parameters" for a complete description of each
  895.           field.  See also "AutoBaud Detect."
  896.  
  897.  
  898.  
  899.                    {COMMO} (tm)  User Guide and Reference           page 14
  900.  
  901.  
  902.        _________________________
  903.  
  904.        Last Called      05/20/90
  905.        _________________________
  906.  
  907.           If this item is present, {COMMO} will replace it with the current
  908.           date whenever a connection is made with the system.  It may
  909.           appear anywhere on the entry line (outside the curly braces). 
  910.           Place "00/00/00" to start it.  The Dialing Directory file will be
  911.           saved to disk when you exit {COMMO}.
  912.  
  913.  
  914.        ============================
  915.        [Alt-G]   Configuration File
  916.        ============================
  917.  
  918.        Pressing Alt-G brings up the Configuration File in edit mode (see
  919.        "Internal Editor" in Online Help for details).
  920.  
  921.        The Configuration File contains settings for many parameters used by
  922.        {COMMO}.  Some of these are "initial" or "start" values only and are
  923.        controlled during a session with key commands.  Others (marked with
  924.        a "*" in the sample file) may be changed for the current session
  925.        using the Internal Editor.
  926.  
  927.        Each item in the Configuration File is enclosed in curly braces and
  928.        must be present even if the contents are "null."  A null item would
  929.        look like this: {}.  All text outside the curly braces is commentary
  930.        and may be deleted to save memory.
  931.  
  932.  
  933.        Explanation of items
  934.        ====================
  935.  
  936.        _________________________________________________________
  937.  
  938.        1 * {2400,8n1,1}
  939.  
  940.           Default Serial Port Parameters: {Speed,Format,Comport}
  941.        _________________________________________________________
  942.  
  943.           These default values will be set at program startup and each time
  944.           dialing begins.  Use the "Serial Port Parameters" item in the
  945.           Dialing Directory to set overrides for the current call.  Use
  946.           Alt-L or the macro function PARMs to set parameters at other
  947.           times.
  948.  
  949.           See "Set Terminal Parameters" for a complete description of each
  950.           field.
  951.  
  952.  
  953.  
  954.                    {COMMO} (tm)  User Guide and Reference           page 15
  955.  
  956.  
  957.        _____________________________________________________
  958.  
  959.        2 * {A}    Default Terminal-Type (Ansi-bbs/Vt102/Tty)
  960.        _____________________________________________________
  961.  
  962.           This default value will be set at program startup and each time
  963.           dialing begins.  Use Alt-L or the macro function TERMinal to
  964.           change it at other times.
  965.  
  966.           See "Set Terminal Parameters" for a complete description.
  967.  
  968.        ________________________________________________
  969.  
  970.        3 * {0}    Default Inter-Character Delay (0-999)
  971.        ________________________________________________
  972.  
  973.           This default value will be set at program startup and each time
  974.           dialing begins.  Use Alt-L or the macro function DELAy to change
  975.           it at other times.
  976.  
  977.           See "Set Terminal Parameters" for a complete description.
  978.  
  979.        _____________________________________________
  980.  
  981.        4 * {no}    Drop DTR and RTS on exit (yes/no)
  982.        _____________________________________________
  983.  
  984.           Leave this "no" if you want to exit {COMMO} and return while
  985.           still connected to a host.  "Yes" will normally cause the modem
  986.           to hang up when exiting.
  987.  
  988.        ______________________________________________________
  989.  
  990.        5 * {yes}    Software (XON/XOFF) Flow Control (yes/no)
  991.        6 * {no}     Hardware (RTS/CTS) Flow Control (yes/no)
  992.        ______________________________________________________
  993.  
  994.           These are used to control the flow of data between your computer
  995.           and the remote system.  They prevent loss of data when one end
  996.           can send faster than the other end can process information.  See
  997.           Appendix C for details.
  998.  
  999.        __________________________________________
  1000.  
  1001.        7 * {AT S0=0 S7=90 E0 Q0 V1 X4 &C1 &D2 |}
  1002.  
  1003.           Modem Init String (2400 bps and higher)
  1004.        __________________________________________
  1005.  
  1006.           This string (up to 128 characters) is normally sent to your modem
  1007.           when {COMMO} is started or when you press Alt-O.
  1008.  
  1009.  
  1010.  
  1011.                    {COMMO} (tm)  User Guide and Reference           page 16
  1012.  
  1013.  
  1014.           If you are using a 1200 bps modem you should remove the "&C1 &D2"
  1015.           commands.  In either case the "X" command may have to be
  1016.           adjusted.  See Appendix A "Setting Up Your Modem."
  1017.  
  1018.        ___________________________________________
  1019.  
  1020.         8 * {.z.,^xB00}       Auto Receive, Zmodem
  1021.         9 * {.m.,^v^h^vMPt}   Auto Receive, MPt
  1022.        10 * {.m.,^v^h^vPuma}  Auto Receive, Puma
  1023.        11 * {}                Auto Receive
  1024.        ___________________________________________
  1025.  
  1026.           The general form of this item is:  {macro-id,string}.  When the
  1027.           specified string (up to 32 characters, case ignored) is received,
  1028.           the macro will be started.  These are normally used for
  1029.           automatically starting downloads, but may be used to trigger any
  1030.           macro upon receiving any string.
  1031.  
  1032.           Set the item to null {} to disable it.  Operates in Terminal Mode
  1033.           only (use GOLOok/LOOKfor in macros).
  1034.  
  1035.        ___________________________________________________
  1036.  
  1037.        12 * {}    Com1    Port address and IRQ overrides.
  1038.        13 * {}    Com2      These are normally left blank.
  1039.        14 * {}    Com3      Refer to COMMO.DOC for
  1040.        15 * {}    Com4      important details.
  1041.        ___________________________________________________
  1042.  
  1043.           Port I/O addresses and IRQ numbers are determined as follows:
  1044.  
  1045.           If there is an address in the DOS port table for the requested
  1046.           serial port, then that address will be used.  Otherwise the
  1047.           {COMMO} default address will be used.  Default base addresses and
  1048.           IRQ numbers for each port (in hex) are:
  1049.  
  1050.                Com#   Address   IRQ
  1051.  
  1052.                  1     3f8       4
  1053.                  2     2f8       3
  1054.                  3     3e8       4
  1055.                  4     2e8       3
  1056.  
  1057.           Port base address and/or IRQ no. may always be overridden.  For
  1058.           example to set Com4, port address = 238, IRQ = 5:
  1059.  
  1060.                {238,5}    Com4
  1061.  
  1062.           Your serial adapter manual may give a range of addresses, for
  1063.           example "3f8-3ff."  Use the first value as the base address.
  1064.  
  1065.  
  1066.  
  1067.                    {COMMO} (tm)  User Guide and Reference           page 17
  1068.  
  1069.  
  1070.           After changing these with the Internal Editor you must use Alt-L
  1071.           to re-initialize the port for the current session (just enter and
  1072.           exit the Alt-L window and {COMMO} will make the necessary
  1073.           adjustments).
  1074.  
  1075.        ___________________________________________________
  1076.  
  1077.        16   {no}    Start with AutoBaud Detect on (yes/no)
  1078.        ___________________________________________________
  1079.  
  1080.           Determines the initial state of the AutoBaud toggle.  See
  1081.           "AutoBaud Detect."
  1082.  
  1083.        ________________________________________________________________
  1084.  
  1085.        17 * {yes}    Clear dialing marks when saving directory (yes/no)
  1086.        ________________________________________________________________ 
  1087.  
  1088.           If this is "yes", dialing marks will not be written to disk when
  1089.           saving the Dialing Directory file.  Set it to "no" if you wish
  1090.           the marks to be saved with the file (to be used in the next
  1091.           session).
  1092.  
  1093.           Note that changes to dialing marks (mark or unmark) will not
  1094.           cause the file to be saved upon exit from {COMMO}.  If no other
  1095.           changes occur (such as Date Last Called), you must use Alt-F in
  1096.           the Internal Editor to save the marks.
  1097.  
  1098.        _____________________________________________
  1099.  
  1100.        18 * {45}    Dialing cycle time-out (seconds)
  1101.        _____________________________________________
  1102.  
  1103.           The maximum time to wait before hanging up and redialing.  Adjust
  1104.           if your modem needs more time to complete a call.
  1105.  
  1106.        ____________________________________________________
  1107.  
  1108.        19 * {2}    Delay between dialing attempts (seconds)
  1109.        ____________________________________________________
  1110.  
  1111.           Amount of time to wait between dialing attempts.  Adjust to give
  1112.           incoming calls a greater chance of getting through.
  1113.  
  1114.  
  1115.  
  1116.                    {COMMO} (tm)  User Guide and Reference           page 18
  1117.  
  1118.  
  1119.        ________________________________________________________________
  1120.  
  1121.        20 * {CONNECT}                       Dialing success response(s)
  1122.        21 * {BUSY,NO CARRIER,NO DIALTONE}   Dialing failure response(s) 
  1123.        ________________________________________________________________
  1124.  
  1125.           These response codes can be found in your modem manual.  Do not
  1126.           include the speed in the CONNECT response if you are enabling
  1127.           AutoBaud.
  1128.  
  1129.           Responses are case sensitive and must be at least 4 characters
  1130.           long.  Maximum length of each item is 80 characters.  There
  1131.           should be no null strings or extra spaces.
  1132.  
  1133.        _______________________________________________________
  1134.  
  1135.        22 * {ATDT}    Dial Prefix #1 (default) see Online Help
  1136.        23 * {}        Dial Prefix #2
  1137.        24 * {}        Dial Prefix #3
  1138.        25 * {}        Dial Prefix #4
  1139.        26 * {|}       Dial Suffix
  1140.        _______________________________________________________
  1141.  
  1142.           These strings (up to 32 characters each) are used to create the
  1143.           dialing command.  The prefix, telephone number and suffix will be
  1144.           strung together in that order and sent to your modem.
  1145.  
  1146.           Any one of the four prefixes may be selected in the telephone
  1147.           number string (see "Dialing Directory").  The default is #1.
  1148.  
  1149.           Use "ATDP" if you don't have a tone line.  Use "ATDT9," to get an
  1150.           outside line on a switchboard.  The suffix is usually just a
  1151.           carriage return (|).  Your modem manual has additional tips on
  1152.           dialing prefixes and suffixes.
  1153.  
  1154.        __________________________________________
  1155.  
  1156.        27 * {c:\commo}    Path to find uploads
  1157.        28 * {c:\commo}    Path to place downloads
  1158.        __________________________________________
  1159.  
  1160.           The upload path will appear in the ASCII Upload window and will
  1161.           also be substituted for "%u" in EXECute macro functions.  The
  1162.           download path will be substituted for "%d" in EXECute macro 
  1163.           functions.
  1164.  
  1165.  
  1166.  
  1167.                    {COMMO} (tm)  User Guide and Reference           page 19
  1168.  
  1169.  
  1170.        ______________________________________________________________
  1171.  
  1172.        29   {c:\commo\commo.cap}    Pathname for initial Capture File
  1173.        ______________________________________________________________
  1174.  
  1175.           If a filename only (no path) is specified, the current directory
  1176.           will be used.  The Capture File pathname is substituted for "%c"
  1177.           in EXECute macro functions.  See also "Capture File Options."
  1178.  
  1179.        _________________________________________
  1180.  
  1181.        30   {c:\commo\commo.scn}
  1182.  
  1183.           Pathname for initial Screen Image file
  1184.        _________________________________________
  1185.  
  1186.           If a filename only (no path) is specified, the current directory
  1187.           will be used. The pathname of an open Capture File is not
  1188.           allowed.  See "Screen Image Save."
  1189.  
  1190.        ___________________________________________________
  1191.  
  1192.        31 * {c:\commo\commo.log}    Pathname for Usage Log
  1193.        ___________________________________________________
  1194.  
  1195.           The Usage Log keeps a record of all the calls you make.  If a
  1196.           valid pathname is specified, entries will be made automatically
  1197.           when you connect to a system and when you disconnect.  Use a null
  1198.           pathname {} to disable the Usage Log.
  1199.  
  1200.           IMPORTANT!  In order for the log to function properly your modem
  1201.           must be set to provide "true carrier detect" (see Appendix A).
  1202.  
  1203.           Specify the same log file as your external protocol driver (e.g.,
  1204.           DSZ.LOG or MPT.LOG) and you will have a complete record of your
  1205.           calls, including upload/download statistics.
  1206.  
  1207.           If a filename only (no path) is specified, the current directory
  1208.           will be used. The pathname of an open Capture File is not
  1209.           allowed.
  1210.  
  1211.        _________________________________________
  1212.  
  1213.        32 * {yes}    Expand blank lines (yes/no)
  1214.        33 * {yes}    Strip linefeeds (yes/no)
  1215.        34   {}       Startup pacing character
  1216.        _________________________________________
  1217.  
  1218.           See "ASCII Upload" for details on these items.
  1219.  
  1220.  
  1221.  
  1222.                    {COMMO} (tm)  User Guide and Reference           page 20
  1223.  
  1224.  
  1225.        __________________________________________________
  1226.  
  1227.        35   {no}    Default to Dialing Directory (yes/no)
  1228.        __________________________________________________
  1229.  
  1230.           If this is set to "yes" the Dialing Directory will be entered
  1231.           when {COMMO} is started.
  1232.  
  1233.        ______________________________________________
  1234.  
  1235.        36   {no}    Start with Local Echo on (yes/no)
  1236.        ______________________________________________
  1237.  
  1238.           If this is set to "yes" Local Echo will be on when {COMMO} is
  1239.           started.  See "Local Echo."
  1240.  
  1241.        _________________________________________________
  1242.  
  1243.        37   {no}    Start with Signal Lights on (yes/no)
  1244.        _________________________________________________
  1245.  
  1246.           If this is set to "yes" Signal Lights will be on when {COMMO} is
  1247.           started.  See "Signal Lights Display."
  1248.  
  1249.        __________________________________________________
  1250.  
  1251.        38   {no}    Start with Capture File open (yes/no)
  1252.        __________________________________________________
  1253.  
  1254.           If this is set to "yes" Capture will be open when {COMMO} is
  1255.           started.  See "Capture File Options."
  1256.  
  1257.        ______________________________________________________________
  1258.  
  1259.        39 * {screen}    Startup Capture File mode (screen/filter/raw)
  1260.        ______________________________________________________________
  1261.  
  1262.           See "Capture File Options" for a description of each mode.
  1263.  
  1264.        ________________________________________________
  1265.  
  1266.        40 * {no}    Test for enhanced keyboard (yes/no)
  1267.        ________________________________________________
  1268.  
  1269.           Set this to "yes" if your system supports the enhanced (101 key)
  1270.           keyboard.  This will enable you to assign F11, F12 and a number
  1271.           of other keys to your macros.  See "Table of {COMMO} Key-id's".
  1272.  
  1273.  
  1274.  
  1275.                    {COMMO} (tm)  User Guide and Reference           page 21
  1276.  
  1277.  
  1278.        ___________________________________________________________
  1279.  
  1280.        41 * {yes}    Display time of day with System Name (yes/no)
  1281.        ___________________________________________________________
  1282.  
  1283.           If this is "yes" only the first 30 characters of the System Name
  1284.           will be displayed on the Status Line.  The time will be displayed
  1285.           in the remaining space.  If "no" the System Name will be
  1286.           displayed in 40 characters.
  1287.  
  1288.        _________________________________________________
  1289.  
  1290.        42   {yes}    Start with Master Sound on (yes/no)
  1291.        _________________________________________________
  1292.  
  1293.           If this is set to "yes" sound will be on when {COMMO} is started. 
  1294.           See "Sound Control."
  1295.  
  1296.        _______________________________________________
  1297.  
  1298.        43 * {yes}    Dialing connection alarm (yes/no)
  1299.        _______________________________________________
  1300.  
  1301.           Controls the alarm signalling a connection when Auto Dialing is
  1302.           used.
  1303.  
  1304.        __________________________________________________
  1305.  
  1306.        44 * {yes}    ASCII Upload finished alarm (yes/no)
  1307.        __________________________________________________
  1308.  
  1309.           Controls the alarm signalling that an ASCII Upload has completed.
  1310.  
  1311.        _________________________________________________
  1312.  
  1313.        45 * {3}    Maximum number of alarm rings (1-999)
  1314.        _________________________________________________
  1315.  
  1316.           Sets the number of times the alarm will ring.  You may press a
  1317.           key at any time to stop the alarm.
  1318.  
  1319.  
  1320.  
  1321.                    {COMMO} (tm)  User Guide and Reference           page 22
  1322.  
  1323.  
  1324.        _______________________________________________________
  1325.  
  1326.        46   {10}    Scrollback buffer size in kilobytes (0-64)
  1327.        _______________________________________________________
  1328.  
  1329.           The actual minimum size of the buffer (which {COMMO} will
  1330.           compute) depends on the number of screen lines.  For a 25 line
  1331.           screen it will be around 4k bytes -- it will be larger for
  1332.           screens with more lines.  This includes room to save the current
  1333.           screen.
  1334.  
  1335.           Setting the size to 0 disables the Scrollback feature.  See
  1336.           "Scrollback" for details.
  1337.  
  1338.        _____________________________________________________________
  1339.  
  1340.        47 * {no}     Snow checking on CGA adapter (yes/no)
  1341.        48 * {yes}    Use BIOS for Terminal Screen scrolling (yes/no)
  1342.        49 * {no}     Use BIOS for Terminal Screen output (yes/no) 
  1343.        _____________________________________________________________
  1344.  
  1345.           Change these video parameters only if necessary.
  1346.  
  1347.           o    Snow checking will slow the display somewhat, but will help
  1348.                to eliminate the "snow" effect.
  1349.  
  1350.           o    BIOS scrolling enables external scrollback programs to work,
  1351.                but may cause "flicker" in certain displays.
  1352.  
  1353.           o    The Terminal Screen BIOS display is intended primarily for
  1354.                use with speech synthesizers (enabling blind users to "see"
  1355.                the computer display).  This also slows the display.
  1356.  
  1357.        ____________________________________________________________
  1358.  
  1359.        50   {no}    Get the number of screen rows from DOS (yes/no)
  1360.        ____________________________________________________________
  1361.  
  1362.           {COMMO} will support 25 or more lines on the display, but you
  1363.           MUST set the display into the proper mode before starting the
  1364.           program (there are utilities to set modes with 43 lines, 50
  1365.           lines, etc.).
  1366.  
  1367.           Set this item to "yes" if you want {COMMO} to obtain the number
  1368.           of lines from DOS.  If your system does not provide this value
  1369.           (most do), leave it "no."
  1370.  
  1371.           Use the "/L=" command line switch to override this item (see
  1372.           "Command Line Options").
  1373.  
  1374.  
  1375.  
  1376.                    {COMMO} (tm)  User Guide and Reference           page 23
  1377.  
  1378.  
  1379.        ______________________________________________________
  1380.  
  1381.        51 * {18}    Number of lines in upper Chat Mode window
  1382.        ______________________________________________________
  1383.  
  1384.           This allows you to adjust the line "split" in Chat Mode.  The
  1385.           minimum number of lines in the upper or lower window is three.
  1386.  
  1387.        _____________________________________________________________
  1388.  
  1389.        52 * {no}    Send when Enter is pressed in Chat Mode (yes/no)
  1390.        _____________________________________________________________
  1391.  
  1392.           If "no" {COMMO} will send each character as you type it.  If
  1393.           "yes" {COMMO} will wait until you press Enter, then send all that
  1394.           you have typed.
  1395.  
  1396.        ____________________________________________
  1397.  
  1398.        53 * {no}    Enable mono attributes (yes/no)
  1399.        ____________________________________________
  1400.  
  1401.           If this is "no" the default mono attributes will be used (this
  1402.           has no effect on color displays).  Set it to "yes" if you want to
  1403.           set your own monochrome attributes (colors).
  1404.  
  1405.        __________________________________________________
  1406.  
  1407.        54 * {07}               Terminal Screen colors
  1408.        55 * {17}               File window text colors
  1409.        56 * {70}               File window border colors
  1410.        57 * {3f}               File window cursor colors
  1411.        58 * {70}               Small window text colors
  1412.        59 * {17}               Small window border colors
  1413.        60 * {17}               Status Line colors
  1414.        __________________________________________________
  1415.  
  1416.           Press F10 in the Configuration File window to pop up the color
  1417.           chart.  You may use it with color or monochrome displays.
  1418.  
  1419.           Note:  For the most accurate ANSI-BBS or VT102 terminal
  1420.           emulation, the Terminal Screen colors should be set to {07}.  In
  1421.           many cases, {COMMO} uses this color when clearing portions of the
  1422.           screen or when a "reset attributes" sequence is received from the
  1423.           host.
  1424.  
  1425.           "File windows" are full-screen windows such as the Dialing
  1426.           Directory, Macro File, Scrollback Buffer, etc.  "Small windows"
  1427.           are the pop up windows such as Capture File Options or ASCII
  1428.           Upload.
  1429.  
  1430.  
  1431.  
  1432.                    {COMMO} (tm)  User Guide and Reference           page 24
  1433.  
  1434.  
  1435.           Colors should be set so that the different parts of the screen
  1436.           contrast with each other.  For example the Status Line should be
  1437.           easily discernable from the rest of the Terminal Screen.  And the
  1438.           borders and Selector Bar should stand out against the text
  1439.           portion of the various windows.
  1440.  
  1441.  
  1442.        ================================
  1443.        [Alt-H]   How to Use Online Help
  1444.        ================================
  1445.  
  1446.        A summary of {COMMO}'s operations is available by pressing Alt-H. 
  1447.        The Online Help support file, COMMO.HLP, must be in the {COMMO} home
  1448.        directory or you will get an error message, "Unable to open Help
  1449.        file."
  1450.  
  1451.        This message will also be issued if there is not enough memory to
  1452.        load the Online Help file.  Note that the file is retained in memory
  1453.        until {COMMO} requires memory for some other program function.  It
  1454.        will automatically be re-read when necessary. 
  1455.  
  1456.        Once the Help window is entered you will see the Help control keys
  1457.        listed at the bottom of the screen.  At this point you may obtain
  1458.        more detailed information about using Online Help by typing "H".
  1459.  
  1460.  
  1461.        Modifying the Help File
  1462.        =======================
  1463.  
  1464.        When you are familiar with {COMMO} you may wish to reduce the size
  1465.        of the Help File.  Feel free to edit this file with an external
  1466.        editor -- you can even set up your own menu.  The search keys are
  1467.        the bars separating the topics.  The two digit number in the middle
  1468.        of the bar may be changed to create your own key.
  1469.  
  1470.        The HELP macro function enables you to assign a key to go directly
  1471.        to any topic in Online Help.  For example:
  1472.  
  1473.                {cf6} {help 12} {}
  1474.  
  1475.        will go to topic 12 when Ctrl-F6 is pressed.
  1476.  
  1477.        If you change the Help File, remember to keep a backup copy of the
  1478.        original.
  1479.  
  1480.  
  1481.  
  1482.                    {COMMO} (tm)  User Guide and Reference           page 25
  1483.  
  1484.  
  1485.        ===========================
  1486.        [Alt-I]   Screen Image Save
  1487.        ===========================
  1488.  
  1489.        The Screen Image Save is used to append all of the text currently on
  1490.        the screen to a disk file.  This is sometimes handier than
  1491.        repeatedly opening and closing the Capture File.
  1492.  
  1493.        TIPS on using Screen Image Save:
  1494.  
  1495.           The pathname may not be the same as the pathname of an open
  1496.           Capture File.
  1497.  
  1498.           If the file cannot be opened, the old pathname is retained.
  1499.  
  1500.        Note:  The current Screen Image Save file is also used to save
  1501.        blocks of text in the Scrollback feature.
  1502.  
  1503.        See also "Capture File Options" and "Scrollback."
  1504.  
  1505.  
  1506.        ====================
  1507.        [Alt-K]   Scrollback
  1508.        ====================
  1509.  
  1510.        Scrollback allows you to see what was previously on your screen. 
  1511.        Screen data is saved to a memory buffer (the size is defined in the
  1512.        Configuration File).  Set the size to 0 to disable the feature
  1513.        entirely.
  1514.  
  1515.        A number of commands are available in Scrollback:
  1516.  
  1517.        1) You may navigate as in the Online Help file -- scroll up/down,
  1518.           page up/down, beginning/end of buffer, etc.
  1519.  
  1520.        2) You may use the String Search feature available in all {COMMO}
  1521.           file windows.
  1522.  
  1523.        3) Any part of the Scrollback buffer may be saved to the current
  1524.           Screen Image Save file.
  1525.  
  1526.        4) You may exit and return to the same place the next time you call
  1527.           Scrollback.
  1528.  
  1529.  
  1530.        =================================
  1531.        [Alt-L]   Set Terminal Parameters
  1532.        =================================
  1533.  
  1534.        Lets you change the current Data Rate, Data Format, Serial Port,
  1535.        Terminal Emulation Type and Inter-Character Delay.
  1536.  
  1537.  
  1538.  
  1539.                    {COMMO} (tm)  User Guide and Reference           page 26
  1540.  
  1541.  
  1542.        Press Alt-L to change the parameters from the Terminal Screen.
  1543.        Observe your changes on the left side of the Status Line.
  1544.  
  1545.        The Terminal Parameters affect the transmission of data to and from
  1546.        your computer.
  1547.  
  1548.  
  1549.        Parameter Descriptions
  1550.        ======================
  1551.  
  1552.           _____
  1553.  
  1554.           Speed
  1555.           _____
  1556.  
  1557.        The rate at which data travels between your computer and the remote
  1558.        system. It is specified as "bits per second" or "bps."  Allowable
  1559.        values are 300, 600, 1200, 2400, 4800, 9600, 19200, 38400, 57600,
  1560.        115200.  These may be abbreviated to the first two characters in
  1561.        Serial Port Parameter strings.
  1562.  
  1563.        See "AutoBaud Detect" for more information on setting the Speed.
  1564.  
  1565.           ___________
  1566.  
  1567.           Data Format
  1568.           ___________
  1569.  
  1570.        This consists of three parts.  Allowable values are:
  1571.  
  1572.           character length:   7, 8
  1573.           parity:             [n]one, [e]ven, [o]dd, [m]ark, [s]pace
  1574.           stop-bits:          1, 2
  1575.  
  1576.        Examples:
  1577.  
  1578.           7o2       7 bit characters, odd parity, 2 stop bits
  1579.           8m1       8 bit characters, mark parity, 1 stop bit
  1580.  
  1581.        The most common formats, "8n1" and "7e1", may be abbreviated to "8"
  1582.        and "7" in parameter strings, such as:
  1583.  
  1584.           {2400,8,1}
  1585.  
  1586.           ___________
  1587.  
  1588.           Serial Port
  1589.           ___________
  1590.  
  1591.        The channel your computer uses to talk to the outside world.  May be
  1592.        1, 2, 3, 4 (for Com1, Com2, Com3, Com4).
  1593.  
  1594.  
  1595.  
  1596.                    {COMMO} (tm)  User Guide and Reference           page 27
  1597.  
  1598.  
  1599.           _______________________
  1600.  
  1601.           Terminal Emulation Type
  1602.           _______________________
  1603.  
  1604.        {COMMO} supports three terminal types:  Use ANSI-BBS (A) for calling
  1605.        most bulletin board systems, VT102 (V) for calling certain
  1606.        mainframes and online services, TTY (T) for turning off almost all
  1607.        control functions (lets you see ANSI control sequences).
  1608.  
  1609.           _____________________
  1610.  
  1611.           Inter-Character Delay
  1612.           _____________________
  1613.  
  1614.        This factor defines the amount of delay to insert between characters
  1615.        transmitted by the SEND macro function and by ASCII Upload.  Use
  1616.        only when the remote is too slow to process the data (drops
  1617.        characters).
  1618.  
  1619.        Each unit is about 5 thousandths of a second (5 ms) on a 4.77 MHz XT
  1620.        class machine.  Faster machines require higher values -- on a 12 MHz
  1621.        AT each unit will only be about 1 ms.
  1622.  
  1623.        For example, to delay 20 ms between characters (50 cps) use a factor
  1624.        of:
  1625.  
  1626.                 4 on 4.77 MHz XT
  1627.                16 on 12 MHz AT
  1628.                27 on 20 MHz 386
  1629.  
  1630.        The factor will also vary when you use multi-tasking software, so
  1631.        adjust as necessary.  The maximum delay allowed is one second.
  1632.  
  1633.  
  1634.        Setting Terminal Parameters
  1635.        ===========================
  1636.  
  1637.           __________________________
  1638.  
  1639.           With the Alt-L Key Command
  1640.           __________________________
  1641.  
  1642.        Alt-L may be used at any time to change parameters "on the fly." 
  1643.        Remember that parameters will be reset to the Configuration File
  1644.        defaults whenever dialing begins.
  1645.  
  1646.  
  1647.  
  1648.                    {COMMO} (tm)  User Guide and Reference           page 28
  1649.  
  1650.  
  1651.           _________________________
  1652.  
  1653.           In the Configuration File
  1654.           _________________________
  1655.  
  1656.        Use the default items (Serial Port Parameters, Terminal-Type, Inter-
  1657.        Character Delay) to establish values that will be used at program
  1658.        startup and when dialing begins.
  1659.  
  1660.           ________________________
  1661.  
  1662.           In the Dialing Directory
  1663.           ________________________
  1664.  
  1665.        Serial Port Parameters may be specified in a Dialing Directory entry
  1666.        to override the default settings.  Specify only values that are
  1667.        different.  For example:
  1668.  
  1669.           {,,3}     Different serial port is required for this call
  1670.  
  1671.           {,8o2}    Unusual format
  1672.  
  1673.           ________________________________________________
  1674.  
  1675.           Using the Macro functions PARMs, TERMinal, DELAy
  1676.           ________________________________________________
  1677.  
  1678.        Use these to set parameters during macro execution.  For example, to
  1679.        set a Terminal-Type during a login macro.  See "Programming {COMMO}
  1680.        Macros."
  1681.  
  1682.  
  1683.        =========================
  1684.        [Alt-M]   Macro Processor
  1685.        =========================
  1686.  
  1687.        The Macro Processor executes and maintains {COMMO} macros.  See the
  1688.        section "Programming {COMMO} Macros" which shows you how easily you
  1689.        can automate program operations, link to external protocols (for
  1690.        Uploading/Downloading), assign keys and perform a myriad of other
  1691.        functions.  The Macro File is maintained with the Internal Editor.
  1692.  
  1693.  
  1694.        ==========================================
  1695.        [Alt-O]   Send Modem Initialization String
  1696.        ==========================================
  1697.  
  1698.        Pressing Alt-O at any time from the Terminal Screen will cause the
  1699.        modem initialization string to be sent to the modem.  This is useful
  1700.        if your modem was powered off or if the modem setup was changed.
  1701.  
  1702.  
  1703.  
  1704.                    {COMMO} (tm)  User Guide and Reference           page 29
  1705.  
  1706.  
  1707.        ===============================
  1708.        [Alt-P]   Send Current Password
  1709.        ===============================
  1710.  
  1711.        The current Password String is defined by dialing a number in the
  1712.        Dialing Directory.  This key command will send the current Password
  1713.        String to the remote system.  This feature allows you to have a
  1714.        different Password String for each system that you call.
  1715.  
  1716.        For additional details on Passwords see "Dialing Directory."
  1717.  
  1718.  
  1719.        =============================
  1720.        [Alt-Q]   Quit Call (hang up)
  1721.        =============================
  1722.  
  1723.        Quits the call by dropping DTR.  This will put the modem "on-hook"
  1724.        if response to DTR is enabled (see Appendix A).  If your modem does
  1725.        not respond properly, you may define a macro to send a "hang-up"
  1726.        command.  For modems using the "AT" command set the macro would look
  1727.        like this:
  1728.  
  1729.           {nf0} {send ~~~+++~~~ATH|} {}    Press F10 to hangup
  1730.           
  1731.        Of course, you may assign this macro to any key you like.
  1732.  
  1733.  
  1734.        ======================
  1735.        [Alt-S]   Shell to DOS
  1736.        ======================
  1737.  
  1738.        When you Shell to DOS {COMMO} remains resident in memory and you may
  1739.        perform any DOS functions as you normally do.  Since {COMMO} is
  1740.        small in size, most of your memory is available when you use this
  1741.        key command.
  1742.  
  1743.  
  1744.        ==============================
  1745.        [Alt-U]   Multi Number Dialing
  1746.        ==============================
  1747.  
  1748.        Any number of entries may be "marked" in the Dialing Directory, then
  1749.        automatically dialed in sequence until a connection is established. 
  1750.        Multi Number Dialing may be initiated in one of four ways:
  1751.  
  1752.        1) Specify entries with Dialing Strings on the command line used to
  1753.           run {COMMO} (see "Command Line Options").  Specified entries will
  1754.           be marked and dialed in sequence when {COMMO} is started.
  1755.  
  1756.        2) Specify entries with Dialing Strings in a macro, using the MARK
  1757.           function (see "Programming {COMMO} Macros").
  1758.  
  1759.  
  1760.  
  1761.                    {COMMO} (tm)  User Guide and Reference           page 30
  1762.  
  1763.  
  1764.        3) Bring up the Dialing Directory window with Alt-D, then move the
  1765.           Selector Bar to each desired entry and press [Space] (repeat the
  1766.           procedure to unmark an entry).  Press Alt-U to begin dialing at
  1767.           the location of the Selector Bar.
  1768.  
  1769.        4) Press Alt-U from the Terminal Screen.  Dialing of marked entries
  1770.           will resume with the next system in the sequence.
  1771.  
  1772.  
  1773.        ===========================
  1774.        [Alt-X]   Exit from {COMMO}
  1775.        ===========================
  1776.  
  1777.        This key command will cause {COMMO} to terminate.  You may configure
  1778.        {COMMO} to leave DTR high when exiting so that you may exit and
  1779.        remain connected to a system (this is the default, see
  1780.        "Configuration File").  Then if you re-enter {COMMO} you would
  1781.        answer "no" to the question about initializing your modem.
  1782.  
  1783.        Alt-X may also be pressed from the Dialing Directory or Macro File
  1784.        windows.
  1785.  
  1786.  
  1787.        ==============================
  1788.        [Alt-1]   Capture File Options
  1789.        ==============================
  1790.  
  1791.        When Capture is OPEN all information written to your screen will be
  1792.        saved to the designated disk file.  This command allows you to:
  1793.  
  1794.           1)   OPEN/CLOSE the Capture File.
  1795.           2)   Change to a different file.
  1796.  
  1797.        Data may be captured in one of three modes.  The startup Capture
  1798.        File Mode is selected in the Configuration File.  The mode may be
  1799.        changed later via the CAPMode macro function.
  1800.  
  1801.           If the mode is set to SCREEN, data will be captured exactly as it
  1802.           appears on the Terminal Screen.  This mode greatly improves the
  1803.           appearance of screens drawn with ANSI positioning sequences
  1804.           (animation).
  1805.  
  1806.           FILTER mode is used primarily when you need to capture lines
  1807.           longer than 80 characters (e.g., to be printed on a wide carriage
  1808.           printer).  ANSI controls will still be stripped out if ANSI-BBS
  1809.           or VT102 emulation is on.
  1810.  
  1811.           Use RAW mode when you want everything captured exactly as it
  1812.           comes from the serial port.  ANSI control sequences will not be
  1813.           stripped and length of lines will be preserved.  This is good for
  1814.           capturing ANSI animation and color to be "played back" later.
  1815.  
  1816.  
  1817.  
  1818.                    {COMMO} (tm)  User Guide and Reference           page 31
  1819.  
  1820.  
  1821.        TIPS on using the Capture File:
  1822.  
  1823.           The old file will be closed if a new file is opened.
  1824.  
  1825.           If Capture File Mode is set to SCREEN, text will be saved as it
  1826.           scrolls OFF the screen.  The entire screen will be saved in the
  1827.           following situations:
  1828.  
  1829.                (1) whenever the screen is cleared
  1830.                (2) Capture is closed with Alt-1
  1831.                (3) {COMMO} is terminated
  1832.                (4) the mode is changed from SCREEN to FILTER or RAW
  1833.  
  1834.           If Capture File Mode is set to FILTER or RAW, text will be saved
  1835.           as it arrives from the serial port.
  1836.  
  1837.        See also "Screen Image Save."
  1838.  
  1839.  
  1840.        ==========================
  1841.        [Alt-2]   Print Log Toggle
  1842.        ==========================
  1843.  
  1844.        Turns the Print Log ON/OFF.  When ON all information written to your
  1845.        screen will be printed to LPT1.  Handy for getting hard-copy of file
  1846.        lists, messages, etc.
  1847.  
  1848.        TIPS on using the Print Log:
  1849.  
  1850.           Text is printed as it scrolls OFF the screen.
  1851.  
  1852.           The entire screen will be printed in the following situations:
  1853.  
  1854.                (1) whenever the screen is cleared
  1855.                (2) Print Log is turned off with Alt-2
  1856.                (3) {COMMO} is terminated
  1857.  
  1858.        Flow Control (see Appendix C) should be used if your printer cannot
  1859.        keep up with the incoming data.
  1860.  
  1861.  
  1862.        ==============================
  1863.        [Alt-3]   Sound Control Toggle
  1864.        ==============================
  1865.  
  1866.        This is the Master Sound Control toggle.  When sound is OFF all
  1867.        alarms, sounds and beeps will be silenced.  Alarms are individually
  1868.        controlled with items in the Configuration File and with the "%a"
  1869.        parameter in EXECute macro functions.
  1870.  
  1871.  
  1872.  
  1873.                    {COMMO} (tm)  User Guide and Reference           page 32
  1874.  
  1875.  
  1876.        =========================
  1877.        [Alt-4]   AutoBaud Toggle
  1878.        =========================
  1879.  
  1880.        AutoBaud Detect enables {COMMO} to automatically adjust to the line
  1881.        speed of the system you are calling, thus relieving you from having
  1882.        to hang up and call back when you get the wrong speed.
  1883.  
  1884.        TIPS on using AutoBaud:
  1885.  
  1886.           Your modem must be set to return the connection speed responses
  1887.           such as "CONNECT 1200" (see Appendix A "Setting Up Your Modem").
  1888.  
  1889.           The default serial port speed in the Configuration File should be
  1890.           set to your modem's highest speed.
  1891.  
  1892.           ____________________
  1893.  
  1894.           Most 2400 bps modems
  1895.           ____________________
  1896.  
  1897.        Toggle AutoBaud Detect to the ON state (uppercase "B" on the Status
  1898.        Line). Set the default speed in the Configuration File to 2400.  The
  1899.        following result-codes will cause the indicated actions:
  1900.  
  1901.           CONNECT 2400  -->  serial port remains at 2400 bps
  1902.           CONNECT 1200  -->  serial port adjusted to 1200 bps
  1903.           CONNECT       -->  serial port adjusted to 300 bps
  1904.  
  1905.           _________________
  1906.  
  1907.           High-speed modems
  1908.           _________________
  1909.  
  1910.  
  1911.        Most high-speed modems require that the serial port be "locked" at
  1912.        19200 bps or 38400 bps.  The modem will then automatically adjust to
  1913.        the line (modem-to-modem) speed.  In this case AutoBaud must be
  1914.        turned OFF to prevent {COMMO} from changing the serial port speed.
  1915.  
  1916.        Some of these modems may also be operated in a mode where the serial
  1917.        port must be adjusted to the speed given in the CONNECT message.  In
  1918.        this case follow the instructions for 2400 bps modems above.
  1919.  
  1920.  
  1921.        ===========================
  1922.        [Alt-5]   Local Echo Toggle
  1923.        ===========================
  1924.  
  1925.        Local Echo is normally used when you connect to a host that does not
  1926.        echo what you type.  {COMMO} will assume that the host is sending a
  1927.        linefeed with each carriage return.
  1928.  
  1929.  
  1930.  
  1931.                    {COMMO} (tm)  User Guide and Reference           page 33
  1932.  
  1933.  
  1934.  
  1935.        Typed characters will be displayed directly to the screen.
  1936.  
  1937.  
  1938.        ==============================
  1939.        [Alt-0]   Signal Lights Toggle
  1940.        ==============================
  1941.  
  1942.        Turns ON/OFF the "modem lights" display on the status line.  Shows
  1943.        the state of the RS-232 signals, including send/receive.
  1944.  
  1945.        This toggles the right half of the Status Line from the System Name
  1946.        to the Signal Lights Display.  See "What is on the Status Line" in
  1947.        Online Help for a complete description of the Status Line
  1948.        indicators.
  1949.  
  1950.  
  1951.        ==========================
  1952.        [Alt--]   Chat Mode Toggle  (Alt minus)
  1953.        ==========================
  1954.  
  1955.        Chat Mode is normally used when you wish to converse via keyboard.
  1956.        The screen will be split with the upper portion showing what the
  1957.        remote is sending, while the lower portion shows what you type.
  1958.  
  1959.        The method used to send typed characters is set in the Configuration
  1960.        File under the section "Video and Chat Mode."  The two possible
  1961.        methods are:
  1962.  
  1963.           1)   Each character as you type it.  This method is normally used
  1964.                when you are chatting with another person who is also in
  1965.                Chat Mode.
  1966.  
  1967.           2)   All characters at once when you press Enter (up to 240
  1968.                characters will be buffered).  Use this method when you are
  1969.                using a teleconferencing system or "CB Simulator."
  1970.  
  1971.        The upper/lower window line split may also be set in the "Video and
  1972.        Chat Mode" section.
  1973.  
  1974.        TIPS on using Chat Mode:
  1975.  
  1976.           Alt-- (Alt minus) is used to enter AND exit Chat Mode.
  1977.  
  1978.           All {COMMO} functions are available in Chat Mode except Doorway
  1979.           Mode.
  1980.  
  1981.  
  1982.  
  1983.                    {COMMO} (tm)  User Guide and Reference           page 34
  1984.  
  1985.  
  1986.        =============================
  1987.        [Alt-=]   Doorway Mode Toggle
  1988.        =============================
  1989.  
  1990.        When Doorway Mode is "on", the status line will disappear and
  1991.        {COMMO} will operate the video display in 25 line mode.  All
  1992.        extended keys (function keys, Alt keys, cursor keys, etc., except
  1993.        for Alt-= ) will send their PC scan codes to the remote.
  1994.  
  1995.        Doorway mode can be used to operate most application software when
  1996.        used with a host program such as Marshall Dudley's Doorway.  In
  1997.        addition some BBS full-screen editors use Doorway Mode.
  1998.  
  1999.        TIPS on using Doorway Mode:
  2000.  
  2001.           If it is necessary to clear the screen or to reset the terminal
  2002.           mode parameters when starting Doorway Mode, use a macro.  For
  2003.           example:
  2004.  
  2005.                {al=} {clear} {term a} {doorway} {}
  2006.  
  2007.           This macro will execute when entering or exiting Doorway Mode
  2008.           (Alt-= must be used to exit, but any key may be assigned to enter
  2009.           Dooryway Mode).
  2010.  
  2011.           For most applications you will want Terminal-Type set to
  2012.           ANSI-BBS.  It's a good idea to enter Doorway Mode before starting
  2013.           the host program.  The host may send commands to initialize the
  2014.           terminal.
  2015.  
  2016.           If Software Flow Control is enabled, the ASCII character values
  2017.           17 and 19 (XON and XOFF) will not display.  If these characters
  2018.           are needed, Software Flow Control must be turned off.
  2019.  
  2020.  
  2021.        =======================
  2022.        Uploading / Downloading
  2023.        =======================
  2024.  
  2025.        ASCII Upload is the only file transfer protocol internal to {COMMO}.
  2026.        The Macro Processor enables you to execute external protocol drivers
  2027.        with ease and rapidity.
  2028.  
  2029.        The Macro File is pre-configured with macros that execute various
  2030.        popular protocol drivers, including DSZ.COM which performs Xmodem,
  2031.        Ymodem and Zmodem uploads and downloads.  Use the Alt-M key command
  2032.        to select one of these macros.  You may add macros for any other
  2033.        protocol drivers that you need.  See "Programming {COMMO} Macros"
  2034.        for details on writing macros.
  2035.  
  2036.  
  2037.  
  2038.                    {COMMO} (tm)  User Guide and Reference           page 35
  2039.  
  2040.  
  2041.        Installing DSZ.COM
  2042.        ==================
  2043.  
  2044.        DSZ is a Shareware program from Omen Technology and is highly
  2045.        recommended for reliable file transfers.  Like {COMMO} it must be
  2046.        registered for continued use.  DSZ may almost always be obtained
  2047.        from the source where you obtained {COMMO} and is usually archived
  2048.        as DSZmmdd.ZIP (mmdd is a release date).
  2049.  
  2050.        To install DSZ just place DSZ.COM in a directory which is specified
  2051.        in your DOS path statement.  If you don't have a path statement in
  2052.        your AUTOEXEC.BAT file, place DSZ.COM in your C:\COMMO directory. 
  2053.        Be sure to change to this directory before you start {COMMO}.
  2054.  
  2055.        MPT.EXE may be installed in a similar fashion for doing MPt (Puma)
  2056.        transfers.
  2057.  
  2058.  
  2059.        {COMMO} Auto Receive
  2060.        ====================
  2061.  
  2062.        This feature will automatically start a macro when a specified
  2063.        string is received from the serial port and is normally used for
  2064.        starting downloads.
  2065.  
  2066.        Up to four strings and respective macro-id's may be defined in the
  2067.        "Terminal and Modem" section of the Configuration File.  These are
  2068.        preconfigured for the Zmodem and MPt protocol "signature" strings,
  2069.        but you may change them or add new ones as desired.
  2070.  
  2071.        Once you have installed the DSZ.COM or MPT.EXE programs (see above)
  2072.        you must change the macro-id's in the Macro File.  These are
  2073.        initialized to {zzz} and {mmm} to prevent {COMMO} from trying to
  2074.        execute programs that aren't there.  Just press Alt-M and change:
  2075.  
  2076.                {zzz}  to  {.z.}  for Zmodem AutoDownload
  2077.                {mmm}  to  {.m.}  for MPt (Puma) Auto-Start
  2078.  
  2079.        Don't change them until you have installed the respective programs.
  2080.        {COMMO} will execute the macro as soon as the signature string is
  2081.        received (be patient, a BBS may take several seconds to load and
  2082.        execute the protocol program).
  2083.  
  2084.        If you have not properly installed the protocol program, the message
  2085.        "Bad command or file name" will be periodically displayed by DOS. 
  2086.        If this happens type Ctrl-X several times to abort the sender and
  2087.        cancel the transfer.
  2088.  
  2089.        TIPS on using Auto Receive:
  2090.  
  2091.           Auto Receive operations are not available in these situations:
  2092.  
  2093.  
  2094.  
  2095.                    {COMMO} (tm)  User Guide and Reference           page 36
  2096.  
  2097.  
  2098.                1)   While a macro is running.
  2099.  
  2100.                2)   Within 2 seconds after a macro has stopped (this
  2101.                     prevents repeated signature strings from triggering the
  2102.                     macro more than once).
  2103.  
  2104.           If you need to download within a macro, you should do a LOOKfor
  2105.           to wait for the signature string, then CALL the download macro
  2106.           (place a RETUrn at the end of it).
  2107.  
  2108.           Using short strings, such as "^E" for CIS B protocol may result
  2109.           in unexpected triggering of the macro.  This is because other
  2110.           systems may send the same string for a different purpose (to
  2111.           display a "club symbol," for example).  Thus it may be necessary
  2112.           to disable a string at times or to discontinue its use.
  2113.  
  2114.           A string may be disabled by removing the corresponding macro-id
  2115.           in the Macro File, but this degrades performance since the Macro
  2116.           File must be scanned each time a "hit" occurs.  Instead the
  2117.           Configuration File item should be replaced with a null {}.
  2118.  
  2119.           An Auto Receive string can be used to automatically continue
  2120.           Multi Number Dialing after you disconnect (in manual mode).  Set
  2121.           one of the strings to:
  2122.  
  2123.                     {ncd,^jNO CARRIER^m}
  2124.  
  2125.           Then enter a macro in the Macro File:
  2126.  
  2127.                     {ncd} {dial ,} {}
  2128.  
  2129.           When your modem sends "NO CARRIER" the macro will start and Multi
  2130.           Number Dialing will resume if any more systems are marked in the
  2131.           Dialing Directory.
  2132.  
  2133.        See also "TIPS on creating LOOKfor strings" in the section
  2134.        describing the LOOKfor function.
  2135.  
  2136.  
  2137.        ==========================
  2138.        Programming {COMMO} Macros
  2139.        ==========================
  2140.  
  2141.        IMPORTANT:  Please read the next few pages before you attempt to
  2142.        write any macros!  The rules for writing {COMMO} macros are few in
  2143.        number, but must be followed carefully.  See the sample Macro File,
  2144.        COMMO.MAC, for examples of more complex macro programming.
  2145.  
  2146.        The following sections assume familiarity with {COMMO}'s key
  2147.        commands and other features.  Since many macro functions have
  2148.        corresponding key commands, duplicate explanations will not be given
  2149.  
  2150.  
  2151.  
  2152.                    {COMMO} (tm)  User Guide and Reference           page 37
  2153.  
  2154.  
  2155.        here.  Refer to the description of the key command in a previous
  2156.        section.
  2157.  
  2158.        {COMMO} macros may be used to perform many different operations, yet
  2159.        their structure is simple and consistent.  Here are some examples:
  2160.  
  2161.           {alk} {clear} {stop}
  2162.  
  2163.        This macro will define Alt-K to clear the screen.  "alk" is called a
  2164.        "macro identifier" or "macro-id" for short.  It may be any three
  2165.        characters.  Certain macro-id's are reserved to represent keys on
  2166.        the keyboard, such as "alk" in this case, and are called "key-id's."
  2167.  
  2168.        CLEAr is called a "function" and is represented by four or more
  2169.        characters of which only the first four are necessary.
  2170.  
  2171.        The STOP function is used here to terminate the macro and may be
  2172.        used in either it's long or short form:
  2173.  
  2174.           ... {stop}          long form
  2175.           ... {}              short form
  2176.  
  2177.        Note that the default key to clear the screen, Alt-C, is still in
  2178.        effect unless it is reassigned.
  2179.  
  2180.        All of {COMMO} key-id's and functions are described in later
  2181.        sections.  They are also summarized in Online Help.
  2182.  
  2183.           {abc}     {setlook 30,hng,3,|} {lookfor first name?}
  2184.                     {send Fred|} {return}
  2185.  
  2186.        In this macro the SETLook function will set timeout parameters for
  2187.        subsequent LOOKfor functions.  The LOOKfor will then watch the data
  2188.        coming in from the modem and when it sees "first name?" control will
  2189.        pass to the next function.  In this case the next function, SEND,
  2190.        will send the string "Fred" followed by a carriage return (indicated
  2191.        by the "|").
  2192.  
  2193.        The macro ends with a RETUrn function.  If the macro was CALLed from
  2194.        another macro, control will return to the CALLing macro.  Otherwise
  2195.        the RETUrn will behave like a STOP.
  2196.  
  2197.           {bbs}     {capture y,commo.cap} {call abc}
  2198.                     {asciiup textfile.xyz,:} {}
  2199.  
  2200.        This macro will open the capture file "commo.cap" (the "y" means
  2201.        "yes", open the file).  Then it will execute the previously
  2202.        described macro "abc."  Then it will ASCII Upload the file
  2203.        "textfile.xyz" using the pacing character ":".
  2204.  
  2205.        Note that macros may occupy more than one line in the Macro File.
  2206.  
  2207.  
  2208.  
  2209.                    {COMMO} (tm)  User Guide and Reference           page 38
  2210.  
  2211.  
  2212.  
  2213.        Macro-id and Function Summary
  2214.        =============================
  2215.  
  2216.        Macro-id's must be three characters (commas and curly braces should
  2217.        not be used).  Case is ignored so that "GK1" is the same as "gk1" or
  2218.        "gK1."
  2219.  
  2220.        Macro-id's may appear anywhere within macros and may be the targets
  2221.        of CALL, GOTO and other functions.  Multiple macro-id's may appear
  2222.        before any function:
  2223.  
  2224.           {aln} {aly} {dial 50,abc} {}.
  2225.  
  2226.        Function names are four or more characters and may always be
  2227.        abbreviated to the first four.  Case is ignored here as well.
  2228.  
  2229.        Remember to terminate each macro with a STOP function unless it
  2230.        already ends with a function which does not return control in line,
  2231.        such as GOTO, RETUrn, EXIT, etc.  If you don't, processing will
  2232.        continue with the next macro in your Macro File!
  2233.  
  2234.  
  2235.        Additional Macro File Rules
  2236.        ===========================
  2237.  
  2238.        The Macro File is entirely free-form.  Macro-id's and functions may
  2239.        appear on the same line or on separate lines.  More that one
  2240.        macro-id may appear on the same line:
  2241.  
  2242.           {ala} {clear} {}    {alw} {sound n} {}
  2243.  
  2244.        Note that only the first may be executed from the Macro File window
  2245.        using the Selector Bar.  Comments may appear anywhere outside the
  2246.        curly braces.
  2247.  
  2248.  
  2249.        Executing Macros
  2250.        ================
  2251.  
  2252.        Macro execution may be started in a number of ways:
  2253.  
  2254.        1) Open the Macro Processor window (Alt-M), position the Selector
  2255.           Bar on the macro-id and press [Enter] (the macro-id must be the
  2256.           first string on the line).
  2257.  
  2258.        2) If the macro-id is also a key-id, then you may press that key
  2259.           from the Terminal Screen.  If the same key-id appears more than
  2260.           once, the first occurrence will be used.
  2261.  
  2262.  
  2263.  
  2264.                    {COMMO} (tm)  User Guide and Reference           page 39
  2265.  
  2266.  
  2267.        3) The macro may be linked to a Dialing Directory entry.  In this
  2268.           case it will be CALLed when a connection is established with that
  2269.           system.
  2270.  
  2271.        4) The macro may be specified on the command line with the switch
  2272.           "/m=".  It will be started as soon as {COMMO} has initialized
  2273.           itself.
  2274.  
  2275.        5) The macro may be an argument of another function such as CALL,
  2276.           GOTO, DIAL or SETLook (these are detailed in a later section).
  2277.  
  2278.  
  2279.        Additional Macro Execution Rules
  2280.        ================================
  2281.  
  2282.        Use [Ctrl-Enter] instead of [Enter] to start a macro and {COMMO}
  2283.        will wait after preparing EXECute functions (before they are
  2284.        executed by DOS).  {COMMO} will also wait before returning to the
  2285.        Terminal Screen so that you may see any error messages from the
  2286.        executing program.
  2287.  
  2288.        ASCII keys may be typed to the serial port during LOOKfor, PAUSe and
  2289.        HOLD functions.
  2290.  
  2291.        The [Esc] key is used to terminate macro processing.  To send an Esc
  2292.        code to the remote (ASCII 27) press Ctrl-[ (Ctrl + left bracket).
  2293.  
  2294.        The Macro Processor will execute functions in order until one of the
  2295.        following conditions occur:
  2296.  
  2297.        1) A CALL, GOTO, RETURn, STOP, EXIT, etc. is encountered.
  2298.  
  2299.        2) Control is transferred to an alternate macro from certain
  2300.           functions when a special condition occurs.  An example of this is
  2301.           the SETLook function.  The alternate will execute when a
  2302.           subsequent LOOKfor times out.
  2303.  
  2304.        3) A macro error occurs.  This will bring up the Macro Error window,
  2305.           indicating the location of the problem.
  2306.  
  2307.        4) [Esc] is pressed.  Macro processing is terminated.
  2308.  
  2309.        5) The end of the Macro File is reached.
  2310.  
  2311.  
  2312.        Current function execution may be terminated by pressing
  2313.        [Ctrl-Break].  For example, this can be used to terminate a LOOKfor,
  2314.        PAUSe or HOLD prematurely.  The macro will advance to the next
  2315.        function.
  2316.  
  2317.  
  2318.  
  2319.                    {COMMO} (tm)  User Guide and Reference           page 40
  2320.  
  2321.  
  2322.        Some macro functions show their current action on the status line at
  2323.        the bottom of the screen.  In addition, a "face" character in the
  2324.        middle of the status line indicates that a macro is executing.
  2325.  
  2326.  
  2327.        =======================
  2328.        {COMMO} Macro Functions
  2329.        =======================
  2330.  
  2331.        The purpose of this section is to show the syntax of each function
  2332.        and the meaning of its arguments through examples.  All functions
  2333.        are listed here, but details on functions which are also default key
  2334.        commands are found in the section "{COMMO} Key Commands."
  2335.  
  2336.        Function names are shown with their four-letter abbreviations in
  2337.        uppercase.  The following conventions are used in many functions:
  2338.  
  2339.           "y" or "yes" is used to indicate "yes", "on",  "open",  etc.
  2340.           "n" or "no"  is used to indicate "no",  "off", "close", etc.
  2341.  
  2342.        This provides a highly consistent macro structure which is very easy
  2343.        to remember.  When a function is also associated with a default key
  2344.        command, the lack of arguments will cause the function to behave
  2345.        like the key command -- bringing up a window or toggling a toggle,
  2346.        for example.
  2347.  
  2348.  
  2349.        Function Arguments
  2350.        ==================
  2351.  
  2352.        Arguments are the parameters that follow the function name.  One
  2353.        space separates the function name from the arguments (extra spaces
  2354.        must be avoided).  Multiple arguments are separated by commas.  
  2355.         
  2356.           {bbs}     {capture y,commo.cap} {call abc}
  2357.                     {asciiup textfile.xyz,:} {return}
  2358.  
  2359.        Here the function CAPTure has two arguments: "y" and "commo.cap."
  2360.  
  2361.           {abc} {lookfor first name?} {send Fred|} {}
  2362.  
  2363.        The function LOOKfor has one argument: "first name?".  Quotation
  2364.        marks are NOT used to enclose data strings or filenames in {COMMO}
  2365.        macros.
  2366.  
  2367.  
  2368.  
  2369.                    {COMMO} (tm)  User Guide and Reference           page 41
  2370.  
  2371.  
  2372.        =======================================
  2373.        Description of Functions (alphabetical)
  2374.        =======================================
  2375.  
  2376.  
  2377.        ALARm
  2378.        -----
  2379.        Default key: none
  2380.        Description: Ring the alarm.
  2381.  
  2382.        Examples:
  2383.  
  2384.           {alarm}             Ring alarm, ring count in Config. File.
  2385.           {alarm 2}           Ring alarm 2 times.
  2386.  
  2387.        {COMMO} will wait until the alarm has stopped ringing before
  2388.        proceeding to the next macro function (the alarm may be terminated
  2389.        early by pressing a key).
  2390.  
  2391.  
  2392.        ASCIiup
  2393.        -------
  2394.        Default key: Alt-A
  2395.        Description: Upload an ASCII (text) file.
  2396.  
  2397.        General form:
  2398.  
  2399.           {ASCIiup pathname,pace}
  2400.  
  2401.                pathname       The complete path and filename (if the path
  2402.                               is absent, the current directory will be
  2403.                               used). 
  2404.  
  2405.                pace           The pacing character to be used.
  2406.  
  2407.        Examples:    
  2408.  
  2409.           {asci}                        Open ASCII Upload window.
  2410.  
  2411.           {asci c:\msgs\file.xyz,:}     Upload "file.xyz."  Use ":" for
  2412.                                         pacing.
  2413.  
  2414.           {asci c:\msgs\file.xyz}       Same, but use current pacing
  2415.                                         character.
  2416.  
  2417.           {asci c:\msgs\file.xyz,}      Same, but no pacing.
  2418.  
  2419.           {asci ,?}                     Set current pacing character to "?"
  2420.  
  2421.           {asci ,}                      Set current pacing to "no" pacing.
  2422.  
  2423.  
  2424.  
  2425.                    {COMMO} (tm)  User Guide and Reference           page 42
  2426.  
  2427.  
  2428.        The pacing character may be entered according to the rules in
  2429.        Appendix D "ASCII Character Representation."  For example, "^m" or
  2430.        "|" may be used to represent the carriage return.
  2431.  
  2432.  
  2433.        AUTObaud
  2434.        --------
  2435.        Default key: Alt-5
  2436.        Description: Set AutoBaud toggle.
  2437.  
  2438.        Examples:
  2439.  
  2440.           {auto}              Toggle AutoBaud on/off
  2441.           {auto y}            Turn on AutoBaud     
  2442.           {auto n}            Turn off AutoBaud
  2443.  
  2444.  
  2445.        BEEP
  2446.        ----
  2447.        Default key: none
  2448.        Description: Sound a beep.
  2449.  
  2450.        Example:
  2451.  
  2452.           {beep}              No arguments.
  2453.  
  2454.  
  2455.        BREAk
  2456.        -----
  2457.        Default key: Alt-B
  2458.        Description: Send a break.
  2459.  
  2460.        Example:
  2461.  
  2462.           {break}             No arguments.
  2463.  
  2464.  
  2465.        CALL
  2466.        ----
  2467.        Default key: none
  2468.        Description: Execute another macro.
  2469.  
  2470.        Example:
  2471.  
  2472.           {call abc}          Execute macro abc.
  2473.  
  2474.        If the macro "abc" executes a RETUrn function, then control returns
  2475.        to the function following the CALL.
  2476.  
  2477.        Note that macros may be nested up to 32 deep.
  2478.  
  2479.  
  2480.  
  2481.                    {COMMO} (tm)  User Guide and Reference           page 43
  2482.  
  2483.  
  2484.        CAPMode
  2485.        -------
  2486.        Default key: none
  2487.        Description: Set Capture File Mode.
  2488.  
  2489.        Examples:
  2490.  
  2491.           {capmode screen}         Set capture mode to SCREEN.
  2492.           {capmode filter}         Set capture mode to FILTER.
  2493.           {capmode raw}            Set capture mode to RAW.
  2494.  
  2495.  
  2496.        CAPTure
  2497.        -------
  2498.        Default key: Alt-1
  2499.        Description: Capture File Options.
  2500.  
  2501.        Examples:
  2502.  
  2503.           {capture}                     Open Capture File Options window.
  2504.  
  2505.           {capture y}                   Open current Capture File.
  2506.  
  2507.           {capture n}                   Close current Capture File.
  2508.  
  2509.           {capt y,c:\commo\file.xyz}    Open indicated Capture File.
  2510.  
  2511.           {capt n,c:\dl\newfile.cap}    Close current Capture File, set new
  2512.                                         file as indicated.
  2513.  
  2514.        Note:  The current Capture File will always be closed when a new
  2515.        file is opened.
  2516.  
  2517.  
  2518.        CHATmode
  2519.        --------
  2520.        Default key: Alt-- (Alt minus)
  2521.        Description: Set Chat Mode toggle.
  2522.  
  2523.        Examples:
  2524.  
  2525.           {chat}              Toggle Chat Mode on/off.
  2526.           {chat y}            Turn on Chat Mode.
  2527.           {chat n}            Turn off Chat Mode.
  2528.  
  2529.  
  2530.        CLEAr
  2531.        -----
  2532.        Default key: Alt-C
  2533.        Description: Clear Terminal Screen to default colors.
  2534.  
  2535.        Example:
  2536.  
  2537.  
  2538.  
  2539.                    {COMMO} (tm)  User Guide and Reference           page 44
  2540.  
  2541.  
  2542.  
  2543.           {clear}             No arguments.
  2544.  
  2545.  
  2546.        CONFig
  2547.        ------
  2548.        Default key: Alt-G
  2549.        Description: Edit Configuration File.
  2550.  
  2551.        Example:
  2552.  
  2553.           {config}            No arguments.
  2554.  
  2555.  
  2556.        CURSor
  2557.        ------
  2558.        Default key: none
  2559.        Description: Terminal Screen cursor on/off.
  2560.  
  2561.        Examples:
  2562.  
  2563.           {cursor}            Toggle Terminal cursor on/off.
  2564.           {curs y}            Turn on Terminal Screen cursor.
  2565.           {curs n}            Turn off Terminal Screen cursor.
  2566.  
  2567.  
  2568.        DELAy
  2569.        -----
  2570.        Default key: none
  2571.        Description: Set Inter-Character Delay factor.
  2572.  
  2573.        Example:
  2574.  
  2575.           {delay 25}          Set factor to 25.
  2576.  
  2577.  
  2578.        DIAL
  2579.        ----
  2580.        Default key: Alt-D, Alt-U
  2581.        Description: Dialing Directory.
  2582.  
  2583.        Examples:
  2584.  
  2585.           {dial}              Open Dialing Directory window (like Alt-D).
  2586.  
  2587.           {dial ,}            Multi Number Dial (like Alt-U).
  2588.  
  2589.           {dial 25,abc}       Multi Number dial with try count.
  2590.  
  2591.        25      Maximum number of dialing tries.  If no connection is
  2592.                established when the try count is exhausted, the macro in
  2593.  
  2594.  
  2595.  
  2596.                    {COMMO} (tm)  User Guide and Reference           page 45
  2597.  
  2598.  
  2599.                the second argument will be started.  May be 0 to 999.  "0"
  2600.                means unlimited.  
  2601.  
  2602.        abc     Macro to GOTO if the try count in the first argument is
  2603.                exhausted.  If no macro is specified or if the macro-id is
  2604.                invalid, control will pass to the next function.
  2605.  
  2606.        Default arguments are:      Dialing tries       0 (unlimited)
  2607.                                    Macro               none
  2608.  
  2609.        Null arguments in the DIAL function will revert to these defaults.
  2610.  
  2611.  
  2612.        Marked numbers will be redialed in sequence.  Numbers may be marked
  2613.        in several ways:
  2614.  
  2615.           1)   Manually in the Dialing Directory window.
  2616.           2)   By placing Dialing Strings on the {COMMO} command line.
  2617.           3)   Using the MARK macro function.
  2618.  
  2619.        If a connection occurs there are two possibilities:
  2620.  
  2621.           1)   If a valid macro-id is specified in the Dialing Directory,
  2622.                that macro will be started.  When a RETUrn function is
  2623.                encountered {COMMO} will continue dialing other numbers if
  2624.                any are marked.  When no more marked numbers are found,
  2625.                control returns following the DIAL function.
  2626.  
  2627.                This allows more than one system to be called with full
  2628.                automation.  When manual operation is desired after login,
  2629.                use a {stop} or {} at the end of the login sequence.  After
  2630.                disconnect press Alt-U to continue Multi Number Dialing.
  2631.  
  2632.           2)   If no macro is specified in the Dialing Directory, control
  2633.                is returned to the Terminal Screen and macro processing is
  2634.                terminated.
  2635.  
  2636.  
  2637.        See also: MARK, UNMArk.
  2638.  
  2639.  
  2640.        DISPlay
  2641.        -------
  2642.        Default key: none
  2643.        Description: Display a string to the screen.
  2644.  
  2645.        General form:
  2646.  
  2647.           {DISPlay row,col,attr,string}
  2648.  
  2649.                row       The row where the string will display.
  2650.                col       The column where the string will display.
  2651.  
  2652.  
  2653.  
  2654.                    {COMMO} (tm)  User Guide and Reference           page 46
  2655.  
  2656.  
  2657.                attr      The attribute (colors) of the string.
  2658.                string    The text of the string (no quotes).
  2659.  
  2660.        Examples:
  2661.  
  2662.           {display 12,20,17,Hello!}     Display "Hello!" at row 12, column
  2663.                                         20.  Colors are white on blue.
  2664.  
  2665.           {disp ,,,Hello, again.^m^j}   Display "Hello, again." at the
  2666.                                         current cursor using the current
  2667.                                         attribute, followed by a cr/lf.
  2668.  
  2669.           {disp 3,40}                   Position the cursor at row 3,
  2670.                                         column 40.
  2671.  
  2672.        The attribute is specified in the same manner as the colors in the
  2673.        Configuration File (press F10 in the Internal Editor to display the
  2674.        Color Chart).
  2675.  
  2676.        Setting background colors to high intensity values will cause
  2677.        blinking (for example, using "9" instead of "1" will still give a
  2678.        blue background but the foreground character will blink).  
  2679.  
  2680.        After the string is displayed, the previous Terminal Screen
  2681.        attribute will be restored.
  2682.  
  2683.  
  2684.        DOORway
  2685.        -------
  2686.        Default key: Alt-=
  2687.        Description: Set Doorway Mode toggle.
  2688.  
  2689.        Examples:
  2690.  
  2691.           {doorway}           Toggle Doorway Mode on/off.
  2692.           {door y}            Turn on Doorway Mode.
  2693.           {door n}            Turn off Doorway Mode.
  2694.  
  2695.  
  2696.        EXECute
  2697.        -------
  2698.        Default key: none
  2699.        Description: Execute a DOS command.
  2700.  
  2701.        This function enables you to "build" a command to be executed by
  2702.        DOS.  A number of special parameters are available which will either
  2703.        substitute the current value of a variable or perform a specific
  2704.        action before or after command execution.
  2705.  
  2706.        In addition, the user input parameter "%i" lets you enter
  2707.        information that is not known until execution time.  For example you
  2708.  
  2709.  
  2710.  
  2711.                    {COMMO} (tm)  User Guide and Reference           page 47
  2712.  
  2713.  
  2714.        can insert a filename (or pathname) at a certain point in the
  2715.        command.
  2716.  
  2717.        The special parameters are detailed here and are also summarized in
  2718.        Online Help.
  2719.  
  2720.           %i   General user input prompt.  May be used more than once in a
  2721.                command and will result in a prompt for input in the
  2722.                "EXECute a DOS Command" window.
  2723.  
  2724.           %p   Current serial port number (1,2,3 or 4).
  2725.  
  2726.           %s   Current serial port speed (2400, 38400, etc.).
  2727.  
  2728.           %m   Current modem speed obtained from the connect message.  For
  2729.                example, "CONNECT 2400" sets %m to "2400".  This is used to
  2730.                pass the modem speed to external protocols (for time
  2731.                estimation) when the serial port is "locked" at a higher
  2732.                speed.
  2733.  
  2734.                If your modem provides a "CARRIER" message containing the
  2735.                modem speed, then set the Dialing Success Response in the
  2736.                Configuration File to "CARRIER" instead of "CONNECT". 
  2737.  
  2738.                Note that this value is "null" when no speed is returned in
  2739.                the connect message.
  2740.  
  2741.           %u   Current upload directory (from Config File).
  2742.  
  2743.           %d   Current download directory (from Config File).
  2744.  
  2745.           %c   Current capture file (use Alt-1 to check).
  2746.  
  2747.           %k   Insert an ASCII control character into the DOS command.  For
  2748.                example to issue a formfeed to your printer you could have
  2749.                the macro function: {exec echo %k^L > prn}.  See Appendix D
  2750.                for rules on representing control characters.
  2751.  
  2752.           %a   Sound the alarm at the end of command execution.
  2753.  
  2754.           %w   Wait (pause) before restoring the Terminal Screen.  This is
  2755.                useful if you need to see the results of the command
  2756.                execution.
  2757.  
  2758.           %%   Insert an actual "%" into the command.
  2759.  
  2760.        Use [Ctrl-Enter] instead of [Enter] to start a macro and you will be
  2761.        able to see the prepared EXECute functions before they are executed
  2762.        by DOS.  {COMMO} will also wait before returning to the Terminal
  2763.        Screen so that you may see any error messages from the executing
  2764.        program.
  2765.  
  2766.  
  2767.  
  2768.                    {COMMO} (tm)  User Guide and Reference           page 48
  2769.  
  2770.  
  2771.  
  2772.        Examples:
  2773.  
  2774.           {exec dsz port %p speed %s sz %u\%i %a%w}
  2775.  
  2776.                {COMMO} will prepare the DSZ command by substituting the "%"
  2777.                parameters, then call DOS to execute the program.
  2778.  
  2779.                Note the "%i".  This will bring up the "Execute a DOS
  2780.                Command" window and prompt you for input (in this case, a
  2781.                filename).
  2782.  
  2783.                The alarm will sound at completion and {COMMO} will wait for
  2784.                a keypress before restoring the Terminal Screen.
  2785.  
  2786.           {exec list %c}
  2787.  
  2788.                The LIST program will be executed with the current Capture
  2789.                File as a command line argument.  {COMMO} will return
  2790.                immediately to the Terminal Screen when LIST exits.
  2791.  
  2792.  
  2793.        EXEN
  2794.        ----
  2795.        Default key: none
  2796.        Description: Execute a DOS command, do not clear the screen.
  2797.  
  2798.        This function is exactly the same as EXECute, but the Terminal
  2799.        Screen is not cleared when the command is sent to DOS.  It is used
  2800.        to produce a smoother transition when programs or DOS commands
  2801.        execute rapidly.
  2802.  
  2803.        Examples:
  2804.  
  2805.           {exen del c:\commo\commo.cap}
  2806.           {exen ren commo.cap joes-bbs.cap}
  2807.  
  2808.  
  2809.        EXIT
  2810.        ----
  2811.        Default key: Alt-X
  2812.        Description: Exit {COMMO}.
  2813.  
  2814.        Example:
  2815.  
  2816.           {exit}              No arguments (return code = 0).
  2817.           {exit 3}            With return code.
  2818.  
  2819.        The return code will be passed to DOS.  It may be tested with the IF
  2820.        ERRORLEVEL batch command.  Range is 0 to 255.
  2821.  
  2822.  
  2823.  
  2824.                    {COMMO} (tm)  User Guide and Reference           page 49
  2825.  
  2826.  
  2827.        GOLOok
  2828.        ------
  2829.        Default key: none
  2830.        Description: Set a macro-id to GOTO if a string comes in during a
  2831.                     subsequent LOOKfor function.
  2832.  
  2833.        Example structure:
  2834.  
  2835.                     {setlook 60,xyz,3,n|}
  2836.                       ...
  2837.  
  2838.           {mac}     {golook aaa,string1}
  2839.                     {golook ,string2}
  2840.                     {golook bbb,string3}
  2841.                     {lookfor string4} {send answer4|} {goto ccc}
  2842.  
  2843.           {aaa}     {send answer1|} {goto mac}
  2844.           {bbb}     {call xyz} {goto mac}
  2845.  
  2846.           {ccc}       ...
  2847.  
  2848.        In this example {COMMO} will look for four strings.  When any string
  2849.        comes in, the LOOKfor is terminated (all strings are cancelled).  It
  2850.        may be set up again by going back to "mac."
  2851.  
  2852.        The GOLOok functions for string1 and string3 will GOTO "aaa" or
  2853.        "bbb" respectively if one of the strings comes in.  In the example
  2854.        control returns to "mac" and the four strings will continue to be
  2855.        looked for.
  2856.  
  2857.        The GOLOok for string2 has a null macro-id and control will pass to
  2858.        the function following the LOOKfor if the string comes in.  The ","
  2859.        must be present.
  2860.  
  2861.        If string4 comes in, control will also pass to the function
  2862.        following the LOOKfor.
  2863.  
  2864.  
  2865.        GOLOok functions should immediately precede a LOOKfor (no string
  2866.        compares actually occur until the LOOKfor).  Up to seven GOLOoks may
  2867.        be used for a total of up to eight strings to look for.
  2868.  
  2869.        Since the LOOKfor is terminated whenever any of the strings come in
  2870.        (or when the LOOKfor timeout expires), this structure is
  2871.        unrestricted -- that is, CALLs, GOTOs, other GOLOok/LOOKfor
  2872.        structures, etc., may be used freely in any of the branches.
  2873.  
  2874.        See "TIPS creating LOOKfor strings" in the section describing the
  2875.        LOOKfor function.
  2876.  
  2877.        See also: LOOKfor, SETLook.
  2878.  
  2879.  
  2880.  
  2881.                    {COMMO} (tm)  User Guide and Reference           page 50
  2882.  
  2883.  
  2884.  
  2885.        GOTO
  2886.        ----
  2887.        Default key: none
  2888.        Description: Transfer control to a macro-id.
  2889.  
  2890.        Example:
  2891.  
  2892.           {goto x21}          Control transferred to macro-id "x21".
  2893.  
  2894.  
  2895.        HANGup
  2896.        ------
  2897.        Default key: Alt-Q
  2898.        Description: Disconnect by dropping DTR.
  2899.  
  2900.        Examples:
  2901.  
  2902.           {hangup}            Prompt user for disconnect.
  2903.           {hangup y}          Disconnect without prompting.
  2904.  
  2905.  
  2906.        HELP
  2907.        ----
  2908.        Default key: Alt-H
  2909.        Description: Open Online Help window.
  2910.  
  2911.        Example:
  2912.  
  2913.           {help}              Display topic 00
  2914.           {help 5}            Display topic 05
  2915.  
  2916.        Topic numbers may range from 00 to 99.  You may create your own
  2917.        Online Help file.  See "Modifying the Help File."
  2918.  
  2919.  
  2920.        HOLD
  2921.        ----
  2922.        Default key: none
  2923.        Description: Hold until specified time of day (24 hour format).
  2924.  
  2925.        Examples:
  2926.  
  2927.           {hold 3:30}         Hold until 3:30 am.
  2928.           {hold 16:10}        Hold until 4:10 pm.
  2929.           {hold 0:00}         Hold until midnight.
  2930.  
  2931.  
  2932.        IFEXist
  2933.        -------
  2934.        Default key: none
  2935.        Description: Test for existence of a disk file.
  2936.  
  2937.  
  2938.  
  2939.                    {COMMO} (tm)  User Guide and Reference           page 51
  2940.  
  2941.  
  2942.  
  2943.        Examples:
  2944.  
  2945.           {ifexist packet.zip,abc,def}       pathname,macro-id,macro-id.
  2946.           {ifex a:file.xyz,,m20}             GOTO "m20" if not found.
  2947.           {ifex c:\data\words.txt,345}       GOTO "345" if found.
  2948.  
  2949.        If the file is found, control will GOTO the first macro-id.  If not
  2950.        found, to the second.  The default when either macro-id is omitted
  2951.        is to pass control to the next function.
  2952.  
  2953.  
  2954.        INITmodem
  2955.        ---------
  2956.        Default key: Alt-O
  2957.        Description: Send Modem Initialization String.
  2958.  
  2959.        Example:
  2960.  
  2961.           {init}              No arguments
  2962.  
  2963.  
  2964.        LIGHts
  2965.        ------
  2966.        Default key: Alt-0
  2967.        Description: Set Signal Lights toggle.
  2968.  
  2969.        Examples:
  2970.  
  2971.           {lights}            Toggle Signal Lights on/off.
  2972.           {lights y}          Turn on Signal Lights.
  2973.           {lights n}          Turn off Signal Lights.
  2974.  
  2975.  
  2976.        LOCAlecho
  2977.        ---------
  2978.        Default key: Alt-6
  2979.        Description: Set Local Echo toggle.
  2980.  
  2981.        Examples:
  2982.  
  2983.           {local}             Toggle Local Echo on/off.
  2984.           {local y}           Turn on Local Echo.
  2985.           {local n}           Turn off Local Echo.
  2986.  
  2987.  
  2988.        LOOKfor
  2989.        -------
  2990.        Default key: none
  2991.        Description: Look for a string in the modem input stream.
  2992.  
  2993.        Examples:
  2994.  
  2995.  
  2996.  
  2997.                    {COMMO} (tm)  User Guide and Reference           page 52
  2998.  
  2999.  
  3000.  
  3001.           {setlook 60,abc,4,n|}    Set parameters.
  3002.           {lookfor first name?}    Look for the string "first name?"
  3003.           {look ^(COMMO^)}         Look for the string "{COMMO}".
  3004.  
  3005.  
  3006.        Parameters controlling LOOKfor execution are set with the SETLook
  3007.        function, which should be executed before any LOOKfor functions. 
  3008.        See description of SETLook function for details.
  3009.  
  3010.        The LOOKfor function will look for the requested string to appear,
  3011.        then macro execution will continue with the next function.  Use the
  3012.        GOLOok function to look for up to seven additional strings during a
  3013.        LOOKfor.
  3014.  
  3015.        TIPS on creating LOOKfor strings:
  3016.  
  3017.           A string is defined starting after the space following the
  3018.           LOOKfor function name and ending just before the right curly
  3019.           brace.  Any spaces in this field are part of the string.
  3020.  
  3021.           GOLOok and Auto Receive strings begin after the comma following
  3022.           the macro-id.
  3023.  
  3024.           Strings may be up to 32 characters in length (control characters
  3025.           like "^M" count as one).  Upper/lower case is ignored.
  3026.  
  3027.           ANSI control sequences are filtered if ANSI or VT102 emulation is
  3028.           enabled.
  3029.  
  3030.           Remember that short strings may not be unique enough, long
  3031.           strings may not match due to line noise.
  3032.  
  3033.           Rules for representing special characters in LOOKfor strings are
  3034.           given in Appendix D "ASCII Character Representation."
  3035.  
  3036.        See also: GOLOok, SETLook.
  3037.  
  3038.  
  3039.        MACLoad
  3040.        -------
  3041.        Default key: none
  3042.        Description: Load a new Macro File.
  3043.  
  3044.        General form:
  3045.  
  3046.           {MACLoad filename,macro-id,r}
  3047.  
  3048.                filename       The new Macro File.  Do not specify a path;
  3049.                               the {COMMO} home directory will be used.
  3050.  
  3051.  
  3052.  
  3053.                    {COMMO} (tm)  User Guide and Reference           page 53
  3054.  
  3055.  
  3056.                macro-id       The macro-id to GOTO when the new file is
  3057.                               loaded.
  3058.  
  3059.                r              Specifies that COMMO.MAC will be reloaded
  3060.                               when carrier is lost.
  3061.  
  3062.        Examples:
  3063.  
  3064.           {macload vt102-1.mac,,r}      Load vt102-1.mac, reload COMMO.MAC
  3065.                                         at the end of the call.
  3066.  
  3067.           {macl newmac.fil,abc}         Load newmac.fil, start macro "abc"
  3068.                                         in the new file.
  3069.  
  3070.  
  3071.        If "r" is specified, be sure to wait for loss of carrier before
  3072.        opening a window (such as the Dialing Directory).  COMMO.MAC cannot
  3073.        be reloaded if any window is on the screen.  You might want to have
  3074.        a macro in the new file to reload COMMO.MAC.  This is especially
  3075.        useful in direct-connect situations (no loss of carrier).  Use with
  3076.        caution on noisy lines.
  3077.  
  3078.        The current file will be saved to disk if changes are outstanding. 
  3079.        The new file is then loaded in place of the current one (all macros
  3080.        are replaced).  
  3081.  
  3082.        MACLoad should be the last function in a macro, since control is not
  3083.        returned.  The new macro file must reside in the {COMMO} home
  3084.        directory (do not specify a path).
  3085.  
  3086.  
  3087.        MACRo
  3088.        -----
  3089.        Default key: Alt-M
  3090.        Description: Open Macro Processor window.
  3091.  
  3092.        Example:
  3093.  
  3094.           {macro}             No arguments.
  3095.  
  3096.  
  3097.        MARK
  3098.        ----
  3099.        Default key: none
  3100.        Description: Mark Dialing Directory entries for dialing.
  3101.  
  3102.        Example:
  3103.  
  3104.           {mark joes-bbs,file-city}     Mark entries for dialing.
  3105.  
  3106.        Dialing Strings may be separated by spaces or commas.
  3107.  
  3108.  
  3109.  
  3110.                    {COMMO} (tm)  User Guide and Reference           page 54
  3111.  
  3112.  
  3113.        {COMMO} will search the Dialing Directory for each string and mark
  3114.        the first entry where a match is found.  Case is ignored.
  3115.        The strings may consist of any part of a Dialing Directory entry
  3116.        line.  However the following characters may not appear in a dialing
  3117.        string: space, comma, slash (/), left or right curly brace. 
  3118.  
  3119.        See also: DIAL, UNMArk.
  3120.  
  3121.  
  3122.        NOOP
  3123.        ----
  3124.        Default key: none
  3125.        Description: No-op function, does nothing
  3126.  
  3127.        Example:
  3128.  
  3129.           {noop}              No arguments.
  3130.  
  3131.  
  3132.        PARMs
  3133.        -----
  3134.        Default key: Alt-L
  3135.        Description: Set Serial Port Parameters
  3136.  
  3137.        General form:
  3138.  
  3139.           {PARMs speed,format,comport}
  3140.  
  3141.                speed          The bps rate, such as 9600.
  3142.                format         The data format, such as 8n1.
  3143.                comport        The serial port number.
  3144.  
  3145.        Examples:
  3146.  
  3147.           {parms 2400,8,1}         Set 2400 bps, 8n1, Com1.
  3148.  
  3149.           {parms ,,4}              Set Com4.
  3150.  
  3151.           {parms 19200,7o1}        Set 19200 bps, 7o1.
  3152.  
  3153.        Note that omitted parameters are not changed.
  3154.  
  3155.  
  3156.        PASSword
  3157.        --------
  3158.        Default key: Alt-P
  3159.        Description: Send current password.
  3160.  
  3161.        Example:
  3162.  
  3163.           {password}          No arguments.
  3164.  
  3165.  
  3166.  
  3167.                    {COMMO} (tm)  User Guide and Reference           page 55
  3168.  
  3169.  
  3170.        The current password is obtained from the Dialing Directory entry
  3171.        whenever a number is dialed.  If no password is specified no
  3172.        characters will be sent.
  3173.  
  3174.  
  3175.        PAUSe
  3176.        -----
  3177.        Default key: none
  3178.        Description: Pause for up to 999 seconds.
  3179.  
  3180.        Example:
  3181.  
  3182.           {pause 25}          Pause for 25 seconds.
  3183.  
  3184.  
  3185.        PRINtlog
  3186.        --------
  3187.        Default key: Alt-2
  3188.        Description: Set Print Log toggle.
  3189.  
  3190.        Examples:
  3191.  
  3192.           {print}             Toggle Print Log on/off.
  3193.           {print y}           Turn on Print Log.
  3194.           {print n}           Turn off Print Log.
  3195.  
  3196.  
  3197.        RETUrn
  3198.        ------
  3199.        Default key: none
  3200.        Description: Return from a CALLed macro.
  3201.  
  3202.        Example:
  3203.  
  3204.           {return}            No arguments.
  3205.  
  3206.        This function is used in the following situations:
  3207.  
  3208.           1)   To end a macro started by a CALL.  Control returns following
  3209.                the CALL function.
  3210.  
  3211.           2)   To end a Dialing Directory macro.  If dialing was initiated
  3212.                from a DIAL macro function, dialing will continue if any
  3213.                more numbers are marked.  If no more numbers are marked,
  3214.                then control will pass to the function following DIAL.
  3215.  
  3216.        Note: If a RETUrn is encountered and no CALL has been executed, a
  3217.        STOP will occur.  This is useful in macros that are CALLed and are
  3218.        also used standalone (such as protocol file transfer macros).
  3219.  
  3220.  
  3221.  
  3222.                    {COMMO} (tm)  User Guide and Reference           page 56
  3223.  
  3224.  
  3225.        SCREen
  3226.        ------
  3227.        Default key: Alt-I
  3228.        Description: Screen Image Save.
  3229.  
  3230.        Examples:
  3231.  
  3232.           {screen}                 Open Screen Image Save window.
  3233.           {screen y}               Append screen image to current file.
  3234.           {screen y,commo.scn}     Append screen image to indicated file.
  3235.                                    (and change current pathname).
  3236.           {screen n,c:\file.xyz}   Change current screen image pathname
  3237.                                    (don't save screen to file).
  3238.  
  3239.  
  3240.        SCROllback
  3241.        ----------
  3242.        Default key: Alt-K
  3243.        Description: Display Scrollback Buffer
  3244.  
  3245.        Example:
  3246.  
  3247.           {scroll}            No arguments.
  3248.  
  3249.  
  3250.        SEND
  3251.        ----
  3252.        Default key: none
  3253.        Description: Send a string to the modem.
  3254.  
  3255.        Example:
  3256.  
  3257.           {send Fred|~~Brucker|~~#|}    Send my first and last name with
  3258.                                         carriage returns and 1 second
  3259.                                         delays, then send the current
  3260.                                         password and <cr>.
  3261.  
  3262.        Note: see Appendix D "ASCII Character Representation" for
  3263.        information on how to represent any character in a SEND function.
  3264.  
  3265.  
  3266.        SETLook
  3267.        -------
  3268.        Default key: none
  3269.        Description: Set parameters for LOOKfor functions.
  3270.  
  3271.        Example:
  3272.  
  3273.           {setl 60,abc,4,n|}       Set LOOKfor parameters
  3274.  
  3275.        60      LOOKfor timeout.  Maximum time in seconds to look for a
  3276.                string.  If the string is not found in the allotted time,
  3277.  
  3278.  
  3279.  
  3280.                    {COMMO} (tm)  User Guide and Reference           page 57
  3281.  
  3282.  
  3283.                the macro in the second argument will be started.  May be 0
  3284.                to 999.  "0" means forever.  
  3285.  
  3286.        abc     Timeout macro.  Macro to GOTO if the time in the first
  3287.                argument expires.  If no macro is specified or if the
  3288.                macro-id is invalid, control will pass to the function
  3289.                following the LOOKfor.
  3290.  
  3291.        4       Prompt timeout.  During a LOOKfor function unwanted prompts
  3292.                may appear like "Press any key" or "More [Y/n]", etc.  
  3293.                This argument is the time in seconds to wait at a prompt (no
  3294.                input from the modem) before sending the string in the
  3295.                fourth argument.  Usually you would send "|" or "n|".
  3296.  
  3297.                When the string is sent the process is restarted, allowing
  3298.                any number of prompts to be satisfied (until the LOOKfor
  3299.                itself is satisfied or times out).
  3300.  
  3301.                The timer will also be reset if any keys are typed while
  3302.                waiting.  This allows a manual response to a prompt which
  3303.                the macro does not handle.
  3304.  
  3305.                Make sure this value is high enough to give the host system
  3306.                time to "think" when it is in between prompts.  Some systems
  3307.                take longer to do things.  May be 0 to 999.  "0" means
  3308.                forever.
  3309.  
  3310.        n|      Prompt response.  String to send when the time in the third
  3311.                argument runs out.  May be up to 32 characters.
  3312.  
  3313.        The SETLook function will set parameters for any subsequent
  3314.        LOOKfor's.  SETLook may be executed at any time to modify the
  3315.        parameters.
  3316.  
  3317.        Default arguments are:      LOOKfor timeout     0 (forever)
  3318.                                    Timeout macro       none 
  3319.                                    Prompt timeout      0 (forever)
  3320.                                    Prompt response     none
  3321.  
  3322.        Null arguments in the SETLook function will revert to these
  3323.        defaults.
  3324.  
  3325.        See also: LOOKfor, GOLOok.
  3326.  
  3327.  
  3328.        SHELl
  3329.        -----
  3330.        Default key: Alt-S
  3331.        Description: Shell to DOS.
  3332.  
  3333.        Example:
  3334.  
  3335.  
  3336.  
  3337.                    {COMMO} (tm)  User Guide and Reference           page 58
  3338.  
  3339.  
  3340.           {shell}             No arguments.
  3341.  
  3342.  
  3343.        SOUNd
  3344.        -----
  3345.        Default key: Alt-3
  3346.        Description: Set Master Sound toggle.
  3347.  
  3348.        Examples:
  3349.  
  3350.           {sound}             Toggle Master Sound on/off.
  3351.           {sound y}           Turn on Master Sound.
  3352.           {sound n}           Turn off Master Sound.
  3353.  
  3354.  
  3355.        STOP
  3356.        ----
  3357.        Default key: none
  3358.        Description: Halt macro execution.
  3359.  
  3360.        Examples:
  3361.  
  3362.           {stop}              No arguments.
  3363.           {}                  Short form.
  3364.  
  3365.        STOP always returns {COMMO} to manual operation in the Terminal
  3366.        Screen.  It should be used to end login macros.
  3367.  
  3368.  
  3369.        TERMinal
  3370.        --------
  3371.        Default key: none
  3372.        Description: Set Terminal Emulation Type.
  3373.  
  3374.        Example:
  3375.  
  3376.           {terminal V}        Set VT102 emulation.
  3377.           {term a}            Set ANSI-BBS emulation.
  3378.           {term t}            Set TTY emulation.
  3379.  
  3380.  
  3381.        UNMArk
  3382.        ------
  3383.        Default key: none
  3384.        Description: Unmark all entries marked for dialing in the Dialing
  3385.                     Directory.
  3386.  
  3387.        Example:
  3388.  
  3389.           {unmark}            No arguments.
  3390.  
  3391.        See also: DIAL, MARK.
  3392.  
  3393.  
  3394.  
  3395.                    {COMMO} (tm)  User Guide and Reference           page 59
  3396.  
  3397.  
  3398.  
  3399.  
  3400.        VTCUr
  3401.        -----
  3402.        Default key: none
  3403.        Description: Define a VT102 cursor (arrow) key.
  3404.  
  3405.        Example:
  3406.  
  3407.           {vtcur ^[[A|^[OA}        Define up-arrow key strings.
  3408.  
  3409.        The first string is sent when cursor mode is active; the second
  3410.        string is sent when application mode is active (these modes are
  3411.        controlled by the host).
  3412.  
  3413.        The two strings must be separated by a "|".  Use "^m" for carriage
  3414.        return if necessary.
  3415.  
  3416.  
  3417.        VTPAd
  3418.        -----
  3419.        Default key: none
  3420.        Description: Define a VT102 keypad key.
  3421.  
  3422.        Example:
  3423.  
  3424.           {vtpad 5|^[Ou}           Define keypad "5" key strings.
  3425.  
  3426.        The first string is sent when numeric mode is active; the second
  3427.        string is sent when application mode is active (these modes are
  3428.        controlled by the host).
  3429.  
  3430.        The two strings must be separated by a "|".  Use "^m" for carriage
  3431.        return if necessary.
  3432.  
  3433.  
  3434.        =========================
  3435.        Table of {COMMO} Key-id's
  3436.        =========================
  3437.  
  3438.        Key-id's are also macro-id's with the added advantage that the macro
  3439.        can be started by pressing the associated key from the Terminal
  3440.        Screen.  Most "special" keys may be assigned this way.  If the same
  3441.        key-id appears more than once, the first occurrence will be used. 
  3442.        Note that key-id's are case insensitive.  The caret (^) indicates
  3443.        the Ctrl key.
  3444.  
  3445.  
  3446.  
  3447.                    {COMMO} (tm)  User Guide and Reference           page 60
  3448.  
  3449.  
  3450.                Key Name     Key-id        Key Name     Key-id
  3451.                ________     ______        ________     ______
  3452.  
  3453.                Normal-F1     nf1   ...    Normal-F10    nf0
  3454.                Ctrl-F1       cf1   ...    Ctrl-F10      cf0
  3455.                Shift-F1      sf1   ...    Shift-F10     sf0
  3456.                Alt-F1        af1   ...    Alt-F10       af0
  3457.  
  3458.                Alt-A         ala   ...    Alt-Z         alz
  3459.                Alt-1         al1   ...    Alt-0         al0
  3460.                Alt =         al=          Alt -         al-
  3461.  
  3462.                Escape        esc          Grey *        gr*
  3463.                Grey -        gr-          Grey +        gr+
  3464.  
  3465.                Backspace     bsp          ^Backspace    cbs
  3466.                Tab           tab          Shift-tab     stb
  3467.                Enter         ent          ^Enter        cen
  3468.  
  3469.                Home          hom          End           end
  3470.                PgUp          pgu          PgDn          pgd
  3471.                Up-Arrow      upa          Down-Arrow    dna
  3472.                Left-Arrow    lfa          Right-Arrow   rta
  3473.                Insert        ins          Delete        del
  3474.  
  3475.                ^Home         chm          ^End          cnd
  3476.                ^PgUp         cpu          ^PgDn         cpd
  3477.                ^Right-Arrow  cra          ^Left-Arrow   cla
  3478.  
  3479.                Keypad-0      kp0   ...    Keypad-9      kp9
  3480.                Keypad-.      kp.          ^PrtSc        cpr
  3481.  
  3482.  
  3483.        Enhanced Keyboard Key-id's
  3484.        ==========================
  3485.  
  3486.                Normal-F11    nfa          Normal-F12    nfb
  3487.                Ctrl-F11      cfa          Ctrl-F12      cfb
  3488.                Shift-F11     sfa          Shift-F12     sfb
  3489.                Alt-F11       afa          Alt-F12       afb
  3490.  
  3491.                Alt-[         al[          Alt-]         al]
  3492.                Alt-'         al'          Alt-`         al`
  3493.                Alt-;         al;          Alt-.         al.
  3494.                Alt-/         al/          Alt-\         al\
  3495.                Alt-*         al*          Center Key    cky
  3496.  
  3497.        The Center Key is the Keypad 5 with Numlock off.
  3498.  
  3499.        The keys in the second group may also work with the 83-key keyboard
  3500.        if your BIOS supports the enhanced keyboard.  Try them.
  3501.  
  3502.  
  3503.  
  3504.                    {COMMO} (tm)  User Guide and Reference           page 61
  3505.  
  3506.  
  3507.  
  3508.        ==========   =====================
  3509.        Appendix A   Setting Up Your Modem
  3510.        ==========   =====================
  3511.  
  3512.        Please be aware that there are many different modems in use and that
  3513.        it is of the utmost importance that you configure your modem to work
  3514.        correctly with {COMMO}.  A few tips will be given here, but they are
  3515.        no substitute for the detailed installation instructions in your
  3516.        modem manual!
  3517.  
  3518.        When {COMMO} is started a command string called the Modem
  3519.        Initialization String will be sent to the modem.  You must make
  3520.        certain that the correct string is set up in your Configuration File
  3521.        (see Online Help).  This string will perform part or all of the
  3522.        modem setup depending on the type of modem.  Examples will be given
  3523.        for the most common types.
  3524.  
  3525.        If your modem is external to your computer, be sure you have
  3526.        followed the installation instructions carefully and that the cable
  3527.        is connected to the computer's serial port.  It is wise to turn off
  3528.        power to the computer and the modem when connecting or disconnecting
  3529.        any cables.
  3530.  
  3531.        Also check Item 1 in the Configuration File -- the Serial Port
  3532.        Parameters.  This string consists of the default speed, data format
  3533.        and port number.  For example if you usually use your modem at 2400
  3534.        bps, data format 8n1, on Com1, your parameter string would be:
  3535.  
  3536.           {2400,8n1,1}
  3537.  
  3538.           _______________
  3539.  
  3540.           1200 bps Modems
  3541.           _______________
  3542.  
  3543.        Most 1200 bps modems have switches on them which must be set to
  3544.        provide the proper interaction with your computer and with {COMMO}. 
  3545.        Consult your modem manual concerning these switches and pay
  3546.        particular attention to the following:
  3547.  
  3548.           1)   Enable command recognition.  Allows the modem to recognize
  3549.                commands (dial, set registers, etc.).  Must be in the
  3550.                "enable" position or modem will be unusable.
  3551.  
  3552.           2)   Send result codes in English.  This switch should be set so
  3553.                that the modem will send verbal responses to commands
  3554.                instead of numbers.  This is usually controlled by a command
  3555.                also (such as ATV1).
  3556.  
  3557.  
  3558.  
  3559.                    {COMMO} (tm)  User Guide and Reference           page 62
  3560.  
  3561.  
  3562.           3)   Respond to DTR (data terminal ready).  This should NOT be in
  3563.                the "ignore" or "on all the time" position.  This switch
  3564.                allows the computer to signal the modem to hang up.
  3565.  
  3566.           4)   Respond to carrier detect or "allow true carrier."  This
  3567.                should NOT be set to the "on all the time" position.
  3568.  
  3569.        Here is an example Modem Initialization String which will set up a
  3570.        1200 bps modem and override the switch settings (if possible):
  3571.  
  3572.           {AT S0=0 S7=60 E0 Q0 V1 X1 |}
  3573.  
  3574.        The most important command to check is the "X" command, since its
  3575.        function varies the most from modem to modem.  The "X" command
  3576.        determines which responses the modem will generate during dialing
  3577.        (e.g. CONNECT, BUSY, etc.).  It may also activate an additional
  3578.        modem feature such as automatic redialing which will interfere with
  3579.        {COMMO}'s own redialing procedure.
  3580.  
  3581.        Your modem manual gives a description for each level of the "X"
  3582.        command: X0, X1, X2, ... , etc.  Generally you want to use the
  3583.        highest level that does not activate undesirable features.  If you
  3584.        will be using {COMMO}'s AutoBaud feature you will need the extended
  3585.        connect responses such as CONNECT 1200.  Also the BUSY response
  3586.        should be provided if possible.  In any case you should modify the
  3587.        Modem Initialization String to work with your particular modem.
  3588.  
  3589.           ___________________
  3590.  
  3591.           2400 bps and higher
  3592.           ___________________
  3593.  
  3594.        Modems which operate at 2400 bps and higher generally have commands
  3595.        to replace the switches (see the section above if yours has
  3596.        switches).  These commands may be given every time you start {COMMO}
  3597.        or they may be permanently remembered by modems which have "non-
  3598.        volatile" memory.
  3599.  
  3600.        It will be assumed here that the commands are given every time you
  3601.        start {COMMO}.  If you wish to place the settings in non-volatile
  3602.        memory, consult your modem manual on how to do this.  Here is an
  3603.        example Modem Initialization String for 2400 bps (and higher)
  3604.        modems:
  3605.  
  3606.           {AT S0=0 S7=60 E0 Q0 V1 X4 &C1 &D2 |}
  3607.  
  3608.        See the comments above concerning the "X" command since they apply
  3609.        to these modems as well.
  3610.  
  3611.  
  3612.        If {COMMO} is already running you may edit the Configuration File
  3613.        with the Alt-G key command, change the Modem Initialization String,
  3614.  
  3615.  
  3616.  
  3617.                    {COMMO} (tm)  User Guide and Reference           page 63
  3618.  
  3619.  
  3620.        then use the Alt-O key command to send the string to the modem. 
  3621.        Normally the string is sent to the modem when {COMMO} is started.
  3622.  
  3623.  
  3624.        ==========   =========================
  3625.        Appendix B   {COMMO} and Multi-Tasking
  3626.        ==========   =========================
  3627.  
  3628.           ________
  3629.  
  3630.           DESQview
  3631.           ________
  3632.  
  3633.        Special care has been taken to ensure that {COMMO} is compatible
  3634.        with Quarterdeck Office Systems' DESQview(tm), a multi-tasking
  3635.        supervisor.  DESQview allows more than one program to execute at the
  3636.        same time.
  3637.  
  3638.        A sample Program Information File (CO-PIF.DVP) has been included in
  3639.        the {COMMO} package for your convenience.  This file has been set up
  3640.        to define a 150k memory window.  You can probably reduce the size of
  3641.        this window considerably if your COMMO.FON and COMMO.MAC files
  3642.        aren't very large -- try 110k or 120k.
  3643.  
  3644.        Test the size of the window by running DSZ, LIST, etc., from the
  3645.        Macro Processor or Shell to DOS.  Be sure to test DOS commands with
  3646.        a "wait" at the end so that you can see any error messages (see EXEC
  3647.        function).  You may be able to make this window smaller by reducing
  3648.        the size of your {COMMO} support files and/or if you only run small
  3649.        programs.
  3650.  
  3651.        CO-PIF.DVP can be changed with the CP (Change Program) command on
  3652.        the Open Window menu.  You may also want to change the directory
  3653.        information or other parameters.
  3654.  
  3655.        TIPS on using {COMMO} with DESQview:
  3656.  
  3657.           If you switch to another task, do not attempt to access any files
  3658.           which may be in use in the {COMMO} window.  Examples are the
  3659.           Capture File, the Screen Image File and files that may be
  3660.           currently involved in a file transfer (upload or download).  The
  3661.           result may be a loss of part or all of the data in the file. 
  3662.           This is a general DESQview no-no.  You may freely access these
  3663.           files in the Shell to DOS or Macro Processor features of {COMMO}
  3664.           (within the same window).
  3665.  
  3666.           If the memory allocated to the window is too small, {COMMO} will
  3667.           not be able to load the Online Help file.  Since the Online Help
  3668.           file is loaded only when requested, you needn't be concerned if
  3669.           you don't intend to use it.
  3670.  
  3671.  
  3672.  
  3673.                    {COMMO} (tm)  User Guide and Reference           page 64
  3674.  
  3675.  
  3676.           The number of screen lines specified in the Configuration File or
  3677.           with the /L= switch should not be larger than what DESQview
  3678.           expects for the type of display adapter you are using.  In other
  3679.           words, 25 for CGA, 43 for EGA, 50 or 60 for VGA, etc.  Otherwise
  3680.           the system may crash.
  3681.  
  3682.           The video display may seem less smooth in DESQview.  This is a
  3683.           result of {COMMO} using the fastest possible display method, and
  3684.           is quite normal.
  3685.  
  3686.           The Snow Checking option should not be used when {COMMO} is run
  3687.           under DESQview.  If you see "snow" type interference in your CGA
  3688.           display, use DESQview's own snow checking (request "synchronized
  3689.           access" in the Setup program).
  3690.  
  3691.           ________
  3692.  
  3693.           OmniView
  3694.           ________
  3695.  
  3696.        Display bleed-through may be avoided by telling OmniView that
  3697.        {COMMO} "Supports TopView Functions" or by using the "/T" switch on
  3698.        the OmniView command line.
  3699.  
  3700.        See "TIPS on using {COMMO} with DESQview" in the previous section,
  3701.        which apply to OmniView as well.
  3702.  
  3703.           _________
  3704.  
  3705.           DoubleDOS
  3706.           _________
  3707.  
  3708.        Color displays require the "DISPLAY = TEXT" option in DDCONFIG.SYS. 
  3709.        Run {COMMO} in the bottom partition -- about 130k to 150k should
  3710.        suffice if you plan to use Online Help and/or external protocols.  
  3711.        Some non-multi-tasker-aware, direct-screen-writing programs executed
  3712.        with the Macro Processor or Shell to DOS may not display properly. 
  3713.        If this happens you may have to run {COMMO} in the top partition.
  3714.  
  3715.        Use the supplied DBLDANSI.SYS driver in place of your ANSI.SYS for
  3716.        running other programs in this partition ({COMMO} doesn't use it).
  3717.  
  3718.        With this setup you may run any non-graphics program in the top
  3719.        partition, including direct screen writers.  
  3720.  
  3721.        Monochrome displays require the REFRESH option in DDCONFIG.SYS. 
  3722.        Refer to the DoubleDOS user's manual for information on this.
  3723.  
  3724.        See "TIPS on using {COMMO} with DESQview" in the previous section,
  3725.        which apply to DoubleDOS as well.
  3726.  
  3727.  
  3728.  
  3729.                    {COMMO} (tm)  User Guide and Reference           page 65
  3730.  
  3731.  
  3732.        ==========   ============
  3733.        Appendix C   Flow Control
  3734.        ==========   ============
  3735.  
  3736.        Flow Control is a signalling system used by communications devices
  3737.        to prevent data from being transmitted faster than it can be
  3738.        processed by the receiving system.  This is especially important
  3739.        when data is transferred at high speeds.
  3740.  
  3741.        Flow Control is activated from the Configuration File and is used by
  3742.        {COMMO} for both sending and receiving.  You may specify Software
  3743.        Flow Control, Hardware Flow Control or both.  Changes may be made at
  3744.        any time using the Internal Editor and will be effective immediately
  3745.        upon exiting the editor.
  3746.         
  3747.        Software Flow Control uses a control character called XOFF (or ^S)
  3748.        to signal the remote to pause.  XON (^Q) is the signal to "resume
  3749.        transmission."  This is normally used only for ASCII data, since
  3750.        these characters may appear randomly within binary data.  An XOFF
  3751.        pause will automatically be released in 20 seconds if no XON is
  3752.        received.  It will also be released if you type a character in the
  3753.        Terminal Screen.
  3754.  
  3755.        Hardware Flow Control uses the RTS/CTS lines in your RS-232-C
  3756.        (serial port) cable to signal pause/resume without interfering with
  3757.        the data.  It should only be used when you are connected to a device
  3758.        which also recognizes RTS/CTS Flow Control (such as a high-speed
  3759.        modem or another computer connected with a null modem cable).  A
  3760.        CTS-off (send) pause will not be released automatically.  Turn off
  3761.        Hardware Flow Control (in the Configuration File) if you need to
  3762.        override it.
  3763.  
  3764.        TIPS on using Flow Control:
  3765.  
  3766.           Your modem must be properly initialized to utilize flow control
  3767.           (consult the manual for details).
  3768.  
  3769.           Since Software Flow Control uses the XOFF (ASCII 19) and XON
  3770.           (ASCII 17) characters, these will not display on the screen.  If
  3771.           it is necessary to display them, Software Flow Control must be
  3772.           turned off.
  3773.  
  3774.           It is especially important to use Flow Control when the Print Log
  3775.           is on, since data is usually received faster than it can be
  3776.           printed.  If you type a character to the remote during a flow
  3777.           control pause, the remote may begin sending again (some systems
  3778.           resume on any character, not just XON).  You may have to turn off
  3779.           the Print Log if this happens.
  3780.  
  3781.  
  3782.  
  3783.                    {COMMO} (tm)  User Guide and Reference           page 66
  3784.  
  3785.  
  3786.        ==========   ==============================
  3787.        Appendix D   ASCII Character Representation
  3788.        ==========   ==============================
  3789.  
  3790.        Sometimes it is necessary to enter special characters in the {COMMO}
  3791.        support files (Configuration File, Dialing Directory and Macro File)
  3792.        or as input to {COMMO} key commands.
  3793.  
  3794.        As an example, suppose you wanted to put a carriage return into a
  3795.        SEND macro function.  If you pressed the Enter key while typing into
  3796.        the Macro File, {COMMO} would think you simply wanted the cursor to
  3797.        go to the beginning of the next line.
  3798.  
  3799.        In other words, certain control characters are used in the operation
  3800.        of {COMMO} and need to be entered in a special way if they are to be
  3801.        used as data.  This section defines how to represent these
  3802.        characters as data.
  3803.  
  3804.  
  3805.        In general, Curly braces { } may ONLY appear as shown in the
  3806.        descriptions and examples for each of the support files.
  3807.  
  3808.  
  3809.        ASCII Data Strings
  3810.        __________________
  3811.  
  3812.        Strings of ASCII characters appear in many places in the {COMMO}
  3813.        support files, including:
  3814.  
  3815.           Modem initialization string        (Config. File)
  3816.           Dial prefixes                      (Config. File)
  3817.           Dial suffix                        (Config. File)
  3818.           Telephone number                   (Dialing Directory)
  3819.           Password string                    (Dialing Directory)
  3820.           Strings in macro functions such as
  3821.                SEND, SETLook and LOOKfor     (Macro File)
  3822.  
  3823.        Note that most of these are sent to the modem.
  3824.  
  3825.  
  3826.        The following characters have special significance in ASCII Data
  3827.        strings:
  3828.  
  3829.           The vertical bar (|) represents a carriage return.
  3830.  
  3831.           The tilde (~) forces a one-half second delay (modem output only).
  3832.  
  3833.           The pound sign (#) will cause the current Password String to be
  3834.           sent in its place (in the SEND function only).
  3835.  
  3836.  
  3837.        Every character in the extended ASCII chart may be represented:
  3838.  
  3839.  
  3840.  
  3841.                    {COMMO} (tm)  User Guide and Reference           page 67
  3842.  
  3843.  
  3844.  
  3845.           The caret (^) is used to represent ASCII values which may not be 
  3846.           entered from the keyboard:
  3847.  
  3848.             0  ... ^@      7  ... ^G      14 ... ^N      21 ... ^U
  3849.             1  ... ^A      8  ... ^H      15 ... ^O      22 ... ^V
  3850.             2  ... ^B      9  ... ^I      16 ... ^P      23 ... ^W
  3851.             3  ... ^C      10 ... ^J      17 ... ^Q      24 ... ^X
  3852.             4  ... ^D      11 ... ^K      18 ... ^R      25 ... ^Y
  3853.             5  ... ^E      12 ... ^L      19 ... ^S      26 ... ^Z
  3854.             6  ... ^F      13 ... ^M      20 ... ^T      27 ... ^[
  3855.  
  3856.           The caret (^) is also used to represent the following:
  3857.  
  3858.             {  ... ^(      the left curly brace
  3859.             }  ... ^)      the right curly brace
  3860.             |  ... ^|      the vertical bar
  3861.             ~  ... ^~      the tilde
  3862.             #  ... ^#      the pound sign
  3863.             ^  ... ^^      the caret
  3864.  
  3865.        These particular characters should only appear in this form, while
  3866.        others such as ASCII 28 through 31 and those in the upper 128
  3867.        extended character set may be typed using the Alt-numeric-keypad
  3868.        method as follows:
  3869.  
  3870.           1. Hold down the Alt key (and keep it down).
  3871.  
  3872.           2. Enter the ASCII code in decimal using the numeric keypad keys
  3873.              (1, 2 or 3 digits are ok).
  3874.  
  3875.           3. Release the Alt key.
  3876.  
  3877.        ASCII 28 through 31 may also be typed using the Ctrl key on your
  3878.        keyboard:
  3879.  
  3880.             28 ... Ctrl \
  3881.             29 ... Ctrl ]
  3882.             30 ... Ctrl 6
  3883.             31 ... Ctrl -
  3884.  
  3885.        All other characters are entered in the usual manner.
  3886.  
  3887.  
  3888.  
  3889.                    {COMMO} (tm)  User Guide and Reference           page 68
  3890.  
  3891.  
  3892.        ==========   ==================
  3893.        Appendix E   Terminal Emulation
  3894.        ==========   ==================
  3895.  
  3896.        Terminal Emulation Type is indicated on the status line (to the
  3897.        right of the Serial Port Parameters string).  Available types are:
  3898.  
  3899.                A   ANSI-BBS   Used on bulletin boards and other systems.
  3900.                V   VT102      Used on minicomputers and mainframes.
  3901.                T   TTY        Supports only the basic control characters.
  3902.  
  3903.        The default Terminal Emulation Type (as defined in the Configuration
  3904.        File) will be set whenever a system is dialed.  It may be changed at
  3905.        any time using the Alt-L key command or the TERMinal macro function.
  3906.  
  3907.        TIPS on using terminal emulation:
  3908.  
  3909.           Whenever a change is made, a reset of mode parameters will be
  3910.           performed.  It is therefore important that the change be made
  3911.           BEFORE (or at the time of) connecting with a host (mode settings
  3912.           may be transmitted by the host).
  3913.  
  3914.           If some screens do not look right when VT102 emulation is used,
  3915.           you may need to turn LINEWRAP on (this should be done from your
  3916.           host system, but some forget to do so).
  3917.  
  3918.           Linewrap may be turned on locally using the DISPlay macro
  3919.           function.  Place the following in your login macro (or assign it
  3920.           to a key and execute it manually):
  3921.  
  3922.                  {display ,,,^[[?7h}
  3923.  
  3924.           If colors do not always look right, it may be necessary to set
  3925.           the Terminal Screen colors in the Configuration File to {07}. 
  3926.           See the note under "Colors" in the Configuration File section.
  3927.  
  3928.  
  3929.        Printer Support
  3930.        ===============
  3931.  
  3932.        {COMMO} supports the ANSI/VT102 printer functions, controlled by the
  3933.        remote system.  The "Printer ON/OFF" function will turn {COMMO}'s
  3934.        Print Log ON/OFF.  The "Dedicated Printing" function will send all
  3935.        input from the serial port directly to the printer.  This allows for
  3936.        "transparent" transmission of printer data, including control codes. 
  3937.        The "Print Screen" function will print the entire current screen.
  3938.  
  3939.        The printer should be on and ready to print when these functions are
  3940.        used.  When "Dedicated Printing" is active no characters will be
  3941.        displayed on the screen.
  3942.  
  3943.  
  3944.  
  3945.                    {COMMO} (tm)  User Guide and Reference           page 69
  3946.  
  3947.  
  3948.        ANSI-BBS Keyboard Support
  3949.        =========================
  3950.  
  3951.        The sample Macro File is set up so you can use the PC keypad keys
  3952.        (arrow keys, PgUp, PgDn, etc.) with most BBS full-screen editors.
  3953.  
  3954.  
  3955.        VT102 Keyboard Simulation
  3956.        =========================
  3957.  
  3958.        Two keyboard files, VT102-1.MAC and VT102-2.MAC, provide support to
  3959.        simulate the VT102 keyboard.  You may merge one of these into
  3960.        COMMO.MAC if you intend to use VT102 all the time (replace the ANSI-
  3961.        BBS keys).  Be sure that you have no conflicting key-id's (remember
  3962.        that {COMMO} will use the first occurrence of a key-id).
  3963.  
  3964.        Or you can use the MACLoad function in your login macro to load the
  3965.        VT102 file automatically when you connect to the host.  Using the
  3966.        "r" option of MACLoad will reload COMMO.MAC at disconnect.  For
  3967.        example:
  3968.  
  3969.           {macload vt102-1.mac,,r}
  3970.  
  3971.        Both files support the following PC keypad functions (^ indicates
  3972.        the Ctrl key):
  3973.  
  3974.                Four cursor (arrow) keys
  3975.                Home   - Home cursor
  3976.                ^Home  - Insert line
  3977.                PgUp   - Page up
  3978.                ^PgUp  - Delete line
  3979.                PgDn   - Page down
  3980.                ^PgDn  - Clear screen
  3981.                End    - End of line
  3982.                Ins    - Insert mode
  3983.                Del    - Delete
  3984.                ^bs   -  Ctrl backspace (delete)
  3985.  
  3986.        VT102 numeric keypad keys are auto-switched by the host system
  3987.        between numeric mode and application mode.
  3988.  
  3989.        The four cursor keys are auto-switched between cursor mode and
  3990.        application mode.
  3991.  
  3992.        These files may be modified to create any keyboard support you
  3993.        desire (see description of VTCUr and VTPAd functions in the section
  3994.        "{COMMO} Macro Functions."
  3995.  
  3996.  
  3997.  
  3998.                    {COMMO} (tm)  User Guide and Reference           page 70
  3999.  
  4000.  
  4001.           ___________
  4002.  
  4003.           VT102-1.MAC
  4004.           ___________
  4005.  
  4006.        This file contains keyboard assignments that work best with the
  4007.        enhanced keyboard (because of the separate cursor keys, etc.).
  4008.  
  4009.        With Numlock ON the ten digits and period will simulate their
  4010.        equivalent VT102 functions.  In addition:
  4011.  
  4012.                F1 to F4 simulate PF1 to PF4
  4013.                Grey * is used for comma
  4014.                Grey - is used for dash
  4015.                Grey + is used for Enter
  4016.  
  4017.           ___________
  4018.  
  4019.           VT102-2.MAC
  4020.           ___________
  4021.  
  4022.        This file contains keyboard assignments that work best with the 83-
  4023.        key keyboard (because of the location of the function keys on the
  4024.        left side).
  4025.  
  4026.        The following diagram shows how the ten function keys (Fn) and ten
  4027.        shifted function keys (SFn) relate to the VT102 keypad keys:
  4028.  
  4029.  
  4030.                F1=  PF1    F2=  PF2    SF1=  PF3    SF2=  PF4
  4031.  
  4032.                F3=   7     F4=   8     SF3=   9     SF4=   -
  4033.  
  4034.                F5=   4     F6=   5     SF5=   6     SF6=   ,
  4035.         
  4036.                F7=   1     F8=   2     SF7=   3     SF8=   Enter
  4037.  
  4038.                F9=   0     F10=  0     SF9=   .     SF10=  Enter
  4039.  
  4040.  
  4041.  
  4042.                    {COMMO} (tm)  User Guide and Reference           page 71
  4043.  
  4044.  
  4045.        ==========   ==========================
  4046.        Appendix F   Error Message Explanations
  4047.        ==========   ==========================
  4048.  
  4049.        If you get an error message that you don't understand, check below
  4050.        for additional information.
  4051.  
  4052.        __________________________
  4053.  
  4054.        Wrong number of braces { }
  4055.        __________________________
  4056.  
  4057.           The Configuration File does not have the correct number of
  4058.           strings (items), or the left and right curly braces are not
  4059.           present in matched pairs.  If necessary compare the file with the
  4060.           original one in the {COMMO} package.
  4061.  
  4062.           If you get this message at program startup, check your "SET
  4063.           COMMO=" command in your AUTOEXEC.BAT file.  It may be specifying
  4064.           a directory that has an old version of COMMO.CFG.
  4065.  
  4066.        ________________________________
  4067.  
  4068.        Sorry, out of memory
  4069.        Not enough memory for Scrollback
  4070.        ________________________________
  4071.  
  4072.           Check the following:
  4073.  
  4074.           1)   {COMMO} cannot allocate its internal buffers.  You must make
  4075.                more memory available.
  4076.  
  4077.           2)   {COMMO} cannot allocate the Scrollback Buffer.  Reduce its
  4078.                size or make more memory available.
  4079.  
  4080.           3)   {COMMO} cannot load the Dialing Directory and/or Macro File. 
  4081.                Try reducing the size of either of these files.  Removing
  4082.                comments may help.  Or make more memory available.
  4083.  
  4084.        _______________________________
  4085.  
  4086.        Cannot locate command processor
  4087.        _______________________________
  4088.  
  4089.           This is an unusual condition.  Type "SET" at the DOS prompt and
  4090.           be sure there is a "COMSPEC=" in the list.  If there is, make
  4091.           sure that COMMAND.COM is in the path specified.
  4092.  
  4093.  
  4094.  
  4095.                    {COMMO} (tm)  User Guide and Reference           page 72
  4096.  
  4097.  
  4098.        ________________________________   
  4099.  
  4100.        SET COMMO= failed, path too long
  4101.        ________________________________
  4102.  
  4103.           The path located in the system environment is too long.  Do
  4104.           another "SET COMMO=" command to correct this.
  4105.  
  4106.        ___________________________
  4107.  
  4108.        Hardware flow control pause
  4109.        ___________________________
  4110.  
  4111.           Hardware Flow Control is in effect and the remote system (or your
  4112.           modem) has requested a pause.  Try waiting a few seconds for the
  4113.           pause to clear; if that fails you may have to turn off Hardware
  4114.           Flow Control (in the Configuration File).
  4115.  
  4116.        _________________________________________
  4117.  
  4118.        File space full!  Delete unnecessary text
  4119.        _________________________________________
  4120.  
  4121.           {COMMO} allows about 65,000 bytes when editing any file (the
  4122.           Dialing Directory and Macro File occupy a common file space). 
  4123.           This limit may be reached when editing any of the files with the
  4124.           Internal Editor.  If this happens you must reduce the size of the
  4125.           file in question.  Try removing comment lines and any other
  4126.           extraneous information.
  4127.  
  4128.           This message may also be the result of loading a resident program
  4129.           (TSR) in the Shell to DOS or via the EXEC macro function.  Other
  4130.           causes involve a corruption of DOS parameters and require
  4131.           rebooting.
  4132.  
  4133.        _____________________
  4134.  
  4135.        Dial command too long
  4136.        _____________________
  4137.  
  4138.           The dial command consists of the dial prefix, the phone number
  4139.           string and the dial suffix.  The total is limited to 72
  4140.           characters.
  4141.  
  4142.        _______________________
  4143.  
  4144.        Bad parameter after "%"
  4145.        _______________________
  4146.  
  4147.           Allowable parameters are listed in the description of the "EXEC"
  4148.           macro function.
  4149.  
  4150.  
  4151.  
  4152.                    {COMMO} (tm)  User Guide and Reference           page 73
  4153.  
  4154.  
  4155.        ________________________
  4156.  
  4157.        Command too long for DOS
  4158.        ________________________
  4159.  
  4160.           DOS commands are limited to 127 characters.
  4161.  
  4162.        ________________________________
  4163.  
  4164.        Unable to open file
  4165.        Unable to open Help File
  4166.        Unable to open Capture File
  4167.        Unable to open Screen Image File
  4168.        File not found
  4169.        Path not found
  4170.        Too many files
  4171.        ________________________________
  4172.  
  4173.           Check the following:
  4174.  
  4175.           1)   That the path exists where the file should be.
  4176.           2)   That the file itself exists (this won't be the problem if
  4177.                the file is being created).
  4178.           3)   Too many files may be open.  You may need to increase your
  4179.                FILES= parameter in CONFIG.SYS.
  4180.           4)   The Online Help File must be less than 64K bytes in size.
  4181.           5)   You cannot use an open Capture File for any other purpose.
  4182.  
  4183.        ______________________________________
  4184.  
  4185.        Check Capture File, disk is full!
  4186.        Check Screen Image file, disk is full!
  4187.        ______________________________________
  4188.  
  4189.           These files should be edited regularly to ensure that they are
  4190.           not occupying too much disk space.
  4191.  
  4192.        _______________________________
  4193.  
  4194.        Not enough memory to load shell
  4195.        Error trying to load shell
  4196.        _______________________________
  4197.  
  4198.           A problem was encountered during Shell to DOS or EXEC macro
  4199.           function.  If memory is not the problem, then a system error
  4200.           condition exists.  Make sure that COMMAND.COM is still available
  4201.           in the "COMSPEC=" path.
  4202.  
  4203.  
  4204.                                    - end -
  4205.  
  4206.